# 快速入门 快速入门 本教程主要是引导您来通过示例和针对合约创建一个子图，以演示整个环境搭建的过程。 1. 首先去[https](https://dashboard.hg.network/)[://dashboard.hg.network](https://dashboard.hg.network/) 去添加一个子图，这个子图请选择部署方式为 API 方式，选择所部署的公链为火币生态链。 ![](https://3485192048-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fhypergraph-decentralized-data-engine%2F-MZ3kP27rG_6eLJ-pgeX%2F-MZ3l0v_TuSkmt-Fd6NE%2F0.png?generation=1619282633994271\&alt=media) 1. 进入子图列表页，可以看到子图列表出现了刚加的子图，所给的提示也跟其他类型方式添加的子图不同，有一个提示按钮 ![](https://3485192048-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fhypergraph-decentralized-data-engine%2F-MZ3kP27rG_6eLJ-pgeX%2F-MZ3l0vaqRanOggYI_qv%2F1.png?generation=1619282633984041\&alt=media) 1. 点击提示按钮，显示出来了详细的部署开发过程中的命令 ![](https://3485192048-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MW7YB7GRRXjYk5nInzl%2F-MZ3kP27rG_6eLJ-pgeX%2F-MZ3ov3c8408DvWTlil4%2F%E5%9B%BE%E7%89%87%201.png?alt=media\&token=2a32c590-290a-402a-bc2a-9ae7bf45a8a0) 下面，我们就根据这些命令来开启子图开发。 1. 初始化一个新子图 初始化新子图要安装 graph-cli 开发包，以使用graph命令来初始化新子图。 可以使用 npm 或者 yarn 来进行全局安装，命令如下： `# NPM` `$ npm install -g @hgdotnetwork/graph-cli` `# Yarn` `$ yarn global add @hgdotnetwork/graph-cli` 在安装的过程中，可能会出错找不到libsecret 库的情况，可以另行安装，比如在Ubuntu 上，通过apt search libsecret ，找到，然后再使用命令 apt install libsecret-1-dev 安装即可。 安装完成，我们执行 graph --help 会得到如下所示的内容： `graph version 0.20.2` `graph -` `build Builds a subgraph and (optionally) uploads it to IPFS` `codegen Generates AssemblyScript types for a subgraph` `create Registers a subgraph name` `auth Sets the access token to use when deploying to a Graph node` `init Creates a new subgraph with basic scaffolding` `remove Unregisters a subgraph name` `test Runs tests against a Graph Node environment (using Ganache by default)` `help (h) -` `version (v) Output the version number` `deploy Deploys the subgraph to a Graph node` 这些命令后面都有比较详细的说明，在后续的流程中，也会提到这些命令的用法，所以这里暂时不展开。 通过这些步骤，我们就安装好了graph 的命令行环境，就可以进行subgraph的开发和部署了。 首先我们通过graph init 创建一个示例项目来了解。 `graph init [options] [subgraph-name] [directory]` `Options:` `--allow-simple-name Use a subgraph name without a prefix (default: false)` `-h, --help Show usage information` `Choose mode with one of:` `--from-contract
Creates a scaffold based on an existing contract` `--from-example Creates a scaffold based on an example subgraph` `Options for --from-contract:` `--abi Path to the contract ABI (default: download from Etherscan)` `--network ` `Selects the network the contract is deployed to` `--index-events Index contract events as entities` `--contract-name Name of the contract (default: Contract)` 从上面的参数可以看到，可以从示例项目创建项目的脚手架 `$ graph init --from-example []` 也可以从合约创建项目 `$ graph init --from-contract --network []` \ 参数在HyperGraph网络中，建议就是在创建的“子图名称/公链名称”构成的，也就是在子图详情页看到的子图名称，比如“subgraphdemo/heco”。 \ 就是项目的目录 \ 就是合约地址，就是子图想要解析的合约地址 \ 即想合约所部署公链所在的网络名称，比如币安智能链就是bsc、火币生态链就是 Heco 下面演示使用一下： `graph init --from-example subgraphdemo/heco --network heco` 我们就可以成功地基于示例项目创建一个脚手架项目。 执行输出如下图所示： ![](https://3485192048-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fhypergraph-decentralized-data-engine%2F-MZ3kP27rG_6eLJ-pgeX%2F-MZ3l0vc1gJ9QSLXsT5E%2F3.png?generation=1619282633997475\&alt=media) 如何基于合约创建也演示一下： `graph init subgraphdemo/heco --network heco --from-contract 0x0bb480582ecae1d22bbaeaccfbb849b441450026` 如果正常运行，可以得到如下输出： ![](https://3485192048-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fhypergraph-decentralized-data-engine%2F-MZ3kP27rG_6eLJ-pgeX%2F-MZ3l0vdZpZdUmW2_1lb%2F4.png?generation=1619282634036693\&alt=media) 从上面的输出可以看到，指定合约和网络，生成一个子图项目，会连接相应的网络的公链浏览器，取回来相应的合约ABI 合约接口定义文件。 如果真的要部署此子图，请在HyperGraph控制台，即[https://dashboard.hg.network](https://dashboard.hg.network/) 也要提交此项目。 ![](https://3485192048-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fhypergraph-decentralized-data-engine%2F-MZ3kP27rG_6eLJ-pgeX%2F-MZ3l0veNIdfj0Wys_At%2F5.png?generation=1619282633987673\&alt=media) 有了这个脚手架项目，我们就能正式进行子图开发，来在子图代码中，对合约的事情进行解析等，后续章节将继续进行讲解。