AssemblyScript API（一）
AssemblyScript API
本节讲解在编写子图映射关系时可以使用哪些内置API。
开箱即用提供的API有两种:
TheGraph TypeScript库(graph-ts)和
graph codegen 命令从子图形文件生成的代码。
如果其他库与AssemblyScript兼容，也可以将其他库添加为依赖项。由于这编写的语言映射，因此可以在 AssemblyScript Wiki上找到语言和标准库功能的更多帮助和资源。因此，Web3 相关的库暂时不能在AssemblyScript 中使用。
安装
使用graph init 创建的子图带有预先配置好的依赖项。安装这些依赖项所需的全部就是运行以下命令之一:
如果子图是从头开始创建的，则以下两个命令之一将安装TheGraph TypeScript库作为依赖项:
API参考
@ graphprotocol / graph-ts 库提供以下API:
一个以太坊API，用于处理以太坊智能合约、事件、区块、交易和以太坊链上的各类值。
一个存储API，用于从HyperGraph节点存储中加载实体以及将实体保存到节点存储中。
一个日志API，用于将消息记录到HyperGraph节点输出和控制台浏览器上。
一个IPFS API，用于从IPFS加载文件。
一个用于解析JSON数据的JSON API。
一个使用加密功能的加密API。
基本类型可以在不同类型系统(例如以太坊，JSON，GraphQL和AssemblyScript)之间转换。
内置类型
可以在AssemblyScript Wiki中找到关于AssemblyScript内置的类型的文档。
为了实现对区块链数据的解析、存储等，@graphprotocol / graph-ts 提供了以下附加类型。
ByteArray 字节数组
ByteArray代表u8(8位无符号整数)类型的数组。
构造:
fromI32(x:i32):ByteArray —— 将x转换为字节数组类型
fromHexString(hex:string):ByteArray——十六进制字符串转换为字节数组，输入长度必须为偶数。带0x前缀是可选的。
类型转换
toHexString():string——将字节数组类型转换为以0x为前缀的十六进制字符串。
toString():string——将字节数组转换为UTF-8字符串。
toBase58():string——将字节数组转换为base58字符串。
toU32():u32——将字节转换为小尾数u32(32位无符号整数)。在溢出的情况下抛出异常。
toI32():i32——将字节数组转换为小端 i32(32位有符号整数)。在溢出的情况下抛出异常。
操作符
equals(y:ByteArray):bool —— 可以写成x == y。
BigDecimal
BigDecimal 用于表示任意精度的小数。
构造
constructor(bigInt:BigInt) —— 从 BigInt 创建一个BigDecimal。
static fromString(s:string):BigDecimal——从十进制字符串解析成 BigDecimal
类型转换
toString():string—— 打印为十进制字符串。
Math
plus(y:BigDecimal):BigDecimal——可以写成x + y。
minus(y:BigDecimal):BigDecimal——可以写成x-y。
times(y:BigDecimal):BigDecimal——可以写成x * y。
splitBy(y:BigDecimal):BigDecimal——可以写为x / y。
equals(y:BigDecimal):bool——可以写成x == y。
notEqual(y:BigDecimal):bool——可以写成x!= y。
lt(y:BigDecimal):bool——可以写成x <y。
le(y:BigDecimal):bool——可以写成x <= y。
gt(y:BigDecimal):bool——可以写成x> y。
ge(y:BigDecimal):bool——可以写成x> = y。
neg():BigDecimal——可以写为-x。
BigInt
BigInt用于表示大整数。这包括 uint32 到 uint256 以及 int64 到 int256的以太坊值。少于 uint32以下的所有值，例如int32，uint24或int8都表示为i32。
BigInt类具有以下API:
构造
BigInt.fromI32(x:i32):BigInt ——从i32创建一个BigInt。
BigInt.fromString(s:string):BigInt ——从字符串中解析一个BigInt。
BigInt.fromUnsignedBytes(x:Bytes):BigInt——将字节解释为无符号，小尾数的整数。如果您输入的是大端整数，请首先调用.reverse()。
BigInt.fromSignedBytes(x:Bytes):BigInt——将字节解释为有符号的小端整数。如果您输入的是大端整数，请首先调用.reverse()。
类型转换
x.toHex():字符串——将BigInt转换为十六进制字符的字符串。
x.toString():字符串——将BigInt转换为十进制数字字符串。
x.toI32():i32——将BigInt作为i32返回；如果该值不是i32（有符号32位整数），则失败。建议首先检查x.isI32()。
x.toBigDecimal():BigDecimal——转换为无小数位数的小数。
数学运算
x.plus(y:BigInt):BigInt——可以写成x + y。
x.minus(y:BigInt):BigInt ——可以写成x-y。
x.times(y:BigInt):BigInt——可以写成x * y。
x.dividedBy(y:BigInt):BigInt——可以写成x / y。
x.mod(y:BigInt):BigInt ——可以写为x％y。
x.equals(y:BigInt):bool ——可以写成x == y。
x.notEqual(y:BigInt):bool——可以写成x！= y。
x.lt(y:BigInt):bool——可以写成x <y。
x.le(y:BigInt):bool——可以写成x <= y。
x.gt(y:BigInt):bool——可以写成x> y。
x.ge(y:BigInt):bool——可以写成x> = y。
x.neg():BigInt ——可以写为-x。
x.divDecimal(y:BigDecimal):BigDecimal——除以小数，得到小数类型的结果。
x.isZero():bool——检查数字是否为零的便捷方法。
x.isI32():bool——检查数字是否是i32。
x.abs():BigInt——绝对值
x.pow(exp:u8):BigInt——求幂
bitOr(x:BigInt,y:BigInt):BigInt ——可以写为x | y。
bitAnd(x:BigInt,y:BigInt):BigInt——可以写为x＆y。
leftShift(x:BigInt,位:u8):BigInt——可以写成x << y。
rightShift(x:BigInt,位:u8):BigInt ——可以写成x >> y。
TypedMap
TypedMap可用于存储键值对。请参阅本示例。 TypedMap类具有以下API： new TypedMap ()——创建一个空映射，其键类型为K，值类型为T map.set(key:K,value:V):void——将key的值设置为value map.getEntry(key:K):TypedMapEntry |null——返回键的键/值对；如果映射中不存在键，则返回null map.get(key:K):V | null——返回键的值；如果映射中不存在键，则返回null map.isSet(key:K):bool——如果映射中存在键值，则返回true;否则返回false
Bytes 字节类型
Bytes 字节类型用于表示任意长度的字节数组。这包括类型为 byte，bytes32 等的以太坊值。 Bytes 类扩展了 AssemblyScript 的Uint8Array，它支持所有Uint8Array功能，以及以下新方法：
b.toHex()—— 返回一个十六进制字符串，表示数组中的字节 b.toString()—— 将数组中的字节转换为一串 unicode 字符 b.toBase58()—— 将以太坊字节值转换为base58编码（用于IPFS哈希）
Address
Address 类型扩展 Bytes 以表示以太坊地址值。 它在 Bytes API之上添加了以下方法： Address.fromString(s:string):Address——从一个十六进制字符串创建一个Address
Last updated