豪翔天下

安装配置

• 开发IDE: 我一般就直接用idea了，有solidity插件，但是以太坊有一个官方的IDE: remix

• 如果是使用hardhat，那么就不用单独安装了，它会安装指定的版本的solc的

1
2
3
4

brew update
brew upgrade
brew tap ethereum/ethereum
brew install solidity

语法

• 可见性修饰符(只能其中一种)

  • public: 任何用户或者合约都能调用和访问
  • private: 只能在本合约内部调用和访问
  • external: 和public类似，不过只能在合约外调用，不能被合约内的其他函数调用
  • Internal: 和private类似，不过可以在继承的子合约中调用副合约的函数

• 函数修饰符

  • view: 可是使用合约中的变量，只是在本地执行，不会消耗gas，不会修改合约状态(例如修改变量、触发事件等)
  • pure: 只能使用局部的变量，入参或者方法内部的变量，既不读取状态，也不改变状态，同样是本地执行，不会消耗gas
  • payable: 表示一个函数能够附加以太币调用，例如一些需要转账的函数

• 函数入参修饰符

  • memory: 表示这里是值传递
  • storage: 表示是指针传递

• 变量分类，注意每个变量在声明时都会有一个对应其类型的默认值(address -> address(0), boolean -> false, enum -> 第一个元素)，没有空值null的概念

  • 状态变量：变量值会一直保存在合约的存储空间中
  • 局部变量：仅在函数执行过程中有效，函数退出后就无效了
  • 全局变量：保存在全局命名空间中的变量，用于获取区块链相关信息

• 内置全局变量

  • block.number(uint): 当前区块号
  • block.timestamp(uint): 当前区块的时间戳，等同于now
  • block.gaslimit(uint): 当前区块的gaslimit
  • msg.sender(address): 消息发送者
  • msg.value(uint): 当前消息的wei值
  • now: 当前区块的时间长
  • tx.gasprice(uint): 当前transaction的gas价格
  • tx.origin(address payable): 当前交易的发送者地址

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

pragma solidity ^0.8.4;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";

contract ERC20Token is ERC20 {	// 支持继承
		IERC20 token;
		
		uint256 override amount; 
		
		mapping (address => bool) public wallets;	// 如果要存储一个list并且要判断其是否存在，没有直接的array判断方法，但是可以用这种mapping来实现，wallets[address]=true, requier(wallet[address], '')

		struct Transaction {	// 创建一个结构体类型
			address user;
			uint timestamp;
		}
		Transaction[] transactions;	// 数组对象
		
		mapping (address => uint256) public investors; // mapping对象，可以用于记录key value的数据

		address public constant MY_ADDRESS = 0x.....;	// 产量可以消耗更低的gas

		// 继承的时候可以写新的构造函数，并且可以将新的构造函数中的参数传递给父类进行初始化
    constructor(uint256 totalSupply, string memory name, string memory symbol, address _anotherToken) ERC20(name, symbol) {
        _mint(msg.sender, totalSupply);
        token IERC20(anotherToken);	// 将另外一个合约作为参数传递进来
        
        
        transactions.push(
        	Transaction('xx', 'bbb')	// 结构体的初始化
        );	// 数组默认有一个push方法
    }
    
    // 获取当前的sender
    function getMsgSender() public view returns(address) {
        return msg.sender;
    }
    
    function func1(unit amount) {
    	require(isAllowed[msg.sender], 'Caller not allowed to mint');	// 类似于断言，只有满足前面的条件才行，否则会报错
    	assert(amount > 123);	// 也是断言，但是没有报错信息
    }
}

salesforce后台配置

• Lightning Experience就是新版的系统，classic就是老版本，新功能以后都只会出现在Lightning Experience中

常用需求操作方式

导出数据

• Setup -> Data -> Data Export -> Export Now -> Start Export，大概等个5到10分钟就能在页面下载了

添加navigation菜单到首页

• Setup -> App Manager ，然后选择自己的首页的app，一般是Force.com，进入编辑页面就能看到Choose the Tabs设置了

跟踪对象或字段的历史修改

• 首先需要再对象的Details设置里面打开Track Field History

• 由于每个对象最多只能设置20个追踪字段，所以默认没有打开，针对单独的字段得单独打开，在Object Manage -> Your Object -> Fields & Relationships

  -> Set History Tracking，选中想要追踪的字段保存即可

• jsforce sdk可以这样查询history

  • 返回的结果中，ParentId才是原始对象的Id，FIeld则是更改的字段

1
2
3
4
5
6
7

// 注意如果是标准对象，那么直接加History即可，例如AccountHistory，如果是自定义对象__c，那么需要将__c替换为__History
conn.sobject('MyCustomObject__History').find({
  ParentId: "xxxxxxxxx",
  Field: "xxx",
  OldValue: "",
  NewValue: "",
})

将自定义的对象添加为tab

增加密码过期时间

• 默认是3个月过期，可以在这里修改Setup -> Security -> Password -> User passwords expire in
• 注意每次修改密码后security token会变更，会发到邮箱里面，如果想再次重置，可以点击头像-> settings->Reset My Security Token

Sandbox

• Sandbox的价格表，没错，是按照原始数据的价格来按百分比收费的，怪不得很多用户都只是partial copy，得自己想办法去将生产数据同步到sandbox中去。
• 如果不用salesforce自己的Refresh方式，那么想要同步production到sandbox，要么借助第三方的收费工具，要么就自己去同步了，自己同步是个体力活，你必须得找到不同对象之间的关系，新插入的数据和之前的ID肯定是不一样的，整个migration程序都得维护这些ID的映射，相当麻烦
• 注意手动刷新sandbox后，相当于删除旧的创建新的，在旧的sandbox环境里面新建的用户会消失的，新的sandbox的users总是和production的一样，只不过email添加了一个后缀.sandboxname

Apps

• AppExchange(App Store)里面的app氛围APP、Component、Consultant

Connected App

• New Connected App 菜单在Apps -> App Manager里面，而不是在Apps -> App Manager -> Connected Apps -> Manage Connected Apps里面

• App Manager和Manage Connected Apps里面如果有相同的app，那么可能这两个菜单点进去会是不同的设置

• 在设置里面可以设置哪些profile能访问这个app，需要注意的是，即使选择的认证方法是POST的，如果你选择了所有人都能访问app(All users may self-authorize)，那么它仍然不会去使用POST认证，会直接用GET去访问app，所以即使我们要所有人都能访问也要选择只允许选择的人(Admin approved users are pre-authorized)，你可以选择所有的profile都行(在app最右边下拉Manage菜单中设置，不是View也不是edit)。注意修改后可能出现You don't have permissions to view application with namespace 错误，只需要在manage菜单的下面Profiles那里选择Manage Profiles，把System Administrator打开即可

• app要允许oauth才能将认证token传到第三方或者自己的callback api

• 如果要作为tab显示在顶部菜单栏，需要

  • 将connected app的canvas打开，并设置canvas app url

  • 创建visualforce page，里面需要包含这个app，创建一个canvas来包含connected app，例如

    1 2 3

    <apex:page standardController="Account"> <apex:canvasApp applicationName="Connected APP的API名称" width="100%" height="5400px" maxHeight="infinite" /> </apex:page>

  • 然后在Setup里面搜索Tabs，在visualforce里面选择它，最后再在首页的tabs里面添加即可

• 创建了带Oauth的app后就能获取到其client_id和client_secret了(也叫Consumer Key和Consumer Secret)

Object & Fields

• 对象的Record Types只是用于前端可以根据某个值来展示不同的表单，例如根据role来确定admin和user能设置哪些字段
• __c结尾表示custom，__r结尾表示relationship

项目配置

• 默认端口为3000，如果要修改可以在src/main.ts中进行修改

1
2
3

# 项目初始化
npm i -g @nestjs/cli
nest new project-name

.env/dotenv配置文件支持

1
2
3
4
5
6
7
8

npm i --save @nestjs/config

// 然后在app.module.ts中引入即可
@Module({
  imports: [ConfigModule.forRoot()], // 如果想要所有modules都能使用可以设置{isGlobal: true}参数
})

process.env.TEST	// 使用

安装和使用

1

npm install web3 --save

• web3下面的api是分部在不同的命名空间的

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// 可以全局用
var Web3 = require('web3');
var web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546');
const web3 = new Web3(new Web3.providers.WebsocketProvider('WSS_ENDPOINT', {
  reconnect: {	// 断开重连选项
    auto: true,
    delay: 5000, // ms
    maxAttempts: 5,
    onTimeout: false
  }
}));
var eth = web3.eth

// 也可以单独用某一个命名空间的
var Eth = require('web3-eth');
var eth = new Eth(Eth.givenProvider || 'ws://some.local-or-remote.node:8546');

// 可以自定义headers
import {HttpHeader} from "web3-core-helpers";
const headers: HttpHeader[] = [{ name: 'token', value: token }];
web3 = new Web3(new Web3.providers.HttpProvider(rpcUrl || '', { headers }));

安装配置

• Cargo是它的包管理工具，类似于npm，可以在这里搜索包crates.io
• 安装完成后cargo, rustc, rustup工具会在~/.cargo/bin中，可以讲他们加入到环境变量中

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh	# 安装rust及对应的工具链

cargo new my_project --bin	# 新建项目，如果是二进制程序就--bin，如果是创建库就--lib
cargo install --locked --path .	# 根据Cargo.lock安装，相当于npm install

cargo build	# 编译
cargo build --release # 进行一些优化进行编译，相当于npm run production
./target/debug/my_project	# 运行编译后的二进制文件
cargo run	#  

# 如果出现error E0554 may not be used on the stable release channel的错误，需要使用nightly模式来安装与性能了
rustup install nightly
cargo +nightly run ...
cargo +nightly install ...
rustup install nightly-2022-03-22	# 安装指定版本的nightly
cargo +nightly-2022-03-22 run ...	# 使用指定版本的nightly

• Cargo.toml：类似于package.json文件

1
2
3
4
5
6

[package]
name = "my_project"
version = "0.0.0.0"

[dependencies]	# 这里可以添加依赖项
dotenv = "0.15.0"

• 能够非常方便地编写、测试并部署智能合约到以太坊
• 内置了Hardhat Network，不用部署到真是的以太坊网络也能进行测试

安装配置

1
2
3
4
5
6
7

npm install -g hardhat
npx hardhat	# 直接初始化项目，会生成一个hardhat.config.js配置文件，选最长的那个最全面了

# 也可以在现有项目中初始化
npm install --save hardhat
npm install --save-dev @nomiclabs/hardhat-ethers ethers @nomiclabs/hardhat-waffle ethereum-waffle chai	# 安装一些测试需要用到的依赖
npx hardhat	# 初始化hardhat项目，可以选择只生成配置文件

Go Ethereum

• 对于RPC端口，如果实在得暴露到公网，其实也没啥，注意不要在network里面创建账户，即使有也要把私钥放到其他地方物理隔离，当然换端口以及防火墙也是基本操作。也可以在nginx层添加一个HTTP basic Auth认证。网上很多黑客一直在扫30303和8545端口

安装配置

1
2
3
4
5
6
7
8
9
10
11

# macos
brew tap ethereum/ethereum
brew install ethereum

# ubuntu
sudo apt-get update
sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install -y ethereum
curl -LSs https://raw.githubusercontent.com/gochain/web3/master/install.sh | sh	# 安装web3 CLI

常用命令

• 直接在节点上创建的账号会生成一个json文件存储在data/keystore下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

geth --datadir ./data account list	# 列出当前所有的account
geth --datadir ./data console	# 进入console

# console控制台命令
personal.newAccount('password')	# 创建账号
personal.unlockAccount('0x111')	# 解锁账号d

eth.accounts	# 获取当前节点所有的账户信息
eth.getBalance(eth.accounts[0])		# 获取某个账户的balance
user1 = eth.accounts[1]	# 在当前console为账户设置别名

admin.nodeInfo	# 获取当前节点信息
admin.peers	# 获取peer节点信息
net.peerCount	# 获取节点数量
eth.blockNumber	# 查看当前区块数量
eth.getBlock(eth.blockNumber - 1) # 获取指定块的详情，包括hash、difficulty, totalDifficulty(直到当前区块的所有difficulty的和)
eth.getTransactionCount('0x0000000')	# 获取指定账户的transaction nonce值
eth.pendingTransactions	# 获取当前所有pending的transaction
eth.coinbase	# 获取当前的矿工

web3 account extract --keyfile data/keystore/UTC--2022-03-16T02-29-14.506737237Z--XXXXXXXX --password XXXXXXXX # 获取在当前网络上创建的账户的私钥

txpool.status # 查看当前pending和queued的transaction的状态
txpool.content.queued
txpool.inspect.queued	# 查看queued的transaction的gas price