truffle.js框架的配置文件

简介: truffle.js是以太坊开发框架,本手册介绍truffle.js 配置文件的位置、windows下的命名冲突解决方案以及各种truffle配置文件选项。

truffle.js是以太坊开发框架,本手册介绍truffle.js 配置文件的位置、windows下的命名冲突解决方案以及各种truffle配置文件选项。

truffle配置文件位置

truffle项目的配置文件位于项目的根目录下,名称为truffle.js。这个文件是一个Javascript脚本,可以在其中执行任意
必要的代码来创建适合你的配置。truffle.js必须导出一个表征你的项目配置的对象,例如:

module.exports = {
  networks: {
    development: {
      host: "127.0.0.1",
      port: 8545,
      network_id: "*" // 可匹配任意网络
    }
  }
};

在这个创建truffle项目时生成的默认配置文件中,声明了一个名为development的以太坊节点,该节点在地址127.0.0.1:8545监听。

WINDOWS下的命名冲突解析

在Windows命令行使用truffle时,默认的配置文件名与truffle冲突 —— 当你在命令行输入truffle时,windows实际上会调用项目目录下
的配置脚本truffle.js。

可以有几种方法解决这一冲突:

  • 输入truffle.cmd全称,例如:
D:\ez-dapp> truffle.cmd compile
  • 修改PATHEXT环境变量,将.js后缀从可执行后缀中删除。
  • 将truffle.js更名为truffle-config.js
  • 使用不会产生冲突的Windows的power Shell或Git BASH。

网络节点选项

指定在部署合约、发送交易时使用哪个网络节点。当在某个特定的网络节点上编译或部署合约时,合约会缓存起来方便后续使用。
当truffle的合约抽象层检查到你连到某个网络节点时,它会使用这个这个网络节点上原有的缓存合约来简化部署流程。

下述的networks对象,通过一个网络名做为配置的键,值对应定义了其网络参数。networks的对应选项不是必须的,但如果一旦指定,
每个网络必须定义一个对应的network_id。如果希望声明一个默认网络,可以通过将netword_id的值标记为default来实现,
当没有匹配到其它的网络时,就会使用默认网络。需要注意的是整个配置中,应该有且仅有一个default的网络。一般来说,
默认网络主要用于开发,配置,合约等数据没有长期保存的需要,网络ID也会因TestRPC的重启而频繁改变时。

网络节点名称在通过用户接口调用时使用。例如,在部署合约时使用--network选项指定要使用的网络节点:

$ truffle migrate --network live

live是truffle.js中定义的某个网络节点:

networks: {
  development: {
    host: "127.0.0.1",
    port: 8545,
    network_id: "*" // match any network
  },
  live: {
    host: "178.25.19.88", // Random IP for example purposes (do not use)
    port: 80,
    network_id: 1,        // Ethereum public network
    // optional config values:
    // gas
    // gasPrice
    // from - default address to use for any transaction Truffle makes during migrations
    // provider - web3 provider instance Truffle should use to talk to the Ethereum network.
    //          - function that returns a web3 provider instance (see below.)
    //          - if specified, host and port are ignored.
  }
}

对于每一个配置的网络节点,在未明确设置以下交易参数时,使用其默认值:

  • gas:部署合约的油耗上限,默认值:4712388
  • gasPrice:部署合约时的油价,默认值:100000000000 wei,即100 shannon
  • from:执行迁移脚本时使用的账户,默认使用节点旳第一个账户
  • provider:默认的provider使用host和port选项构造:new Web3.providers.HttpProvider("http://host:port")

对于配置的每个网络节点,你可以设置provider或host/port,但不能同时使用。如果你需要一个
HTTP provider,推荐使用host/port选项,如果需要一个定制的provider,例如HDWalletProvider,
那么必须使用provider选项。

合约编译输出目录选项:CONTRACTS_BUILD_DIRECTORY

合约编译的默认输出目录是项目根目录下的./build/contracts,不过这一点可以在配置文件中
使用contracts_build_directory配置项进行修改。

例如,你可以将合约编译结果存放在项目根目录的./output/contracts目录下:

module.exports = {
  contracts_build_directory: "./output",
  networks: {
    development: {
      host: "127.0.0.1",
      port: 8545,
      network_id: "*",
    }
  }
};

编译生成的合约构件也可以不放在项目目录下,例如:

module.exports = {
  contracts_build_directory: "../../../output",
  networks: {
    development: {
      host: "127.0.0.1",
      port: 8545,
      network_id: "*",
    }
  }
};

当然你也可以使用绝对路径,不过我们不推荐这么做,因为如果在其他机器上
构建你的项目,可能会找不到你设定的绝对路径。如果在windows下使用绝对
路径,记得转义反斜杠,例如:C:\\Users\\Username\\output

测试框架选项:MOCHA

使用mocha选项传入MochaJS测试框架需要的配置选项,例如:

mocha: {
  useColors: true
}

关于mochajs的配置内容,请查阅其官方文档

solidity编译选项:SOLC

使用solc选项传入solity编译器需要的选项,例如:

solc: {
  optimizer: {
    enabled: true,
    runs: 200
  }
}

关于solidity编译器选项的详细内容,请查阅编译器输入与输出的JSON描述

如果你希望高效的学习以太坊DApp开发,可以访问汇智网提供的最热门在线互动教程:

其他更多内容也可以访问这个以太坊博客

相关文章
|
1月前
|
开发框架 JavaScript 安全
js开发:请解释什么是Express框架,以及它在项目中的作用。
Express是Node.js的Web开发框架,简化路由管理,支持HTTP请求处理。它采用中间件系统增强功能,如日志和错误处理,集成多种模板引擎(EJS、Jade、Pug)用于HTML渲染,并提供安全中间件提升应用安全性。其可扩展性允许选用合适插件扩展功能,加速开发进程。
|
3月前
|
前端开发 JavaScript 开发者
什么是 Angular 框架中的 Zone.js
什么是 Angular 框架中的 Zone.js
27 0
|
4月前
|
开发框架 JSON JavaScript
Node.js教程-express框架
Node.js教程-express框架
39 1
|
4月前
|
JavaScript 前端开发
【前端开发】一文带你精通Vue.js框架(一)
【前端开发】一文带你精通Vue.js框架(一)
52 0
|
14天前
|
JavaScript 前端开发 API
框架分析(3)-Vue.js
框架分析(3)-Vue.js
|
1月前
|
前端开发 JavaScript 机器人
详解《基于 javascript 的流程图编辑框架LogicFlow
详解《基于 javascript 的流程图编辑框架LogicFlow
73 0
|
1月前
|
前端开发 JavaScript 开发者
编程笔记 html5&css&js 014 网页布局框架
编程笔记 html5&css&js 014 网页布局框架
|
1月前
|
前端开发 JavaScript API
编程笔记 html5&css&js 011 HTML内连框架
编程笔记 html5&css&js 011 HTML内连框架
|
2月前
|
设计模式 前端开发 JavaScript
开源专访:Strve.js框架作者Vam
开源专访:Strve.js框架作者Vam
40 2
|
2月前
|
开发框架 JavaScript 前端开发
比较两个突出的node.js框架:koa和express
接上文讲述了 koa框架,这边文章比较一下这两个突出的node.js框架:koa和express