2021-11-25 08:33:32 +00:00
|
|
|
Contract ABI
|
|
|
|
============
|
|
|
|
|
|
|
|
Implements encoding of parameters according to the Ethereum
|
|
|
|
[Contract ABI Specification][1].
|
|
|
|
|
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
|
|
|
Use the [Nimble][2] package manager to add `contractabi` to an existing project.
|
|
|
|
Add the following to its .nimble file:
|
|
|
|
|
|
|
|
```nim
|
|
|
|
requires "https://github.com/status-im/nim-contract-abi >= 0.1.0 & < 0.2.0"
|
|
|
|
```
|
|
|
|
|
|
|
|
Usage
|
|
|
|
-----
|
|
|
|
|
|
|
|
```nim
|
|
|
|
import contractabi
|
|
|
|
import stint
|
|
|
|
|
|
|
|
# encode unsigned integers, booleans, enums
|
|
|
|
AbiEncoder.encode(42'u8)
|
|
|
|
|
|
|
|
# encode uint256
|
|
|
|
AbiEncoder.encode(42.u256)
|
|
|
|
|
|
|
|
# encode byte arrays and sequences
|
|
|
|
AbiEncoder.encode([1'u8, 2'u8, 3'u8])
|
|
|
|
AbiEncoder.encode(@[1'u8, 2'u8, 3'u8])
|
|
|
|
|
|
|
|
# encode tuples
|
2021-12-01 09:58:23 +00:00
|
|
|
AbiEncoder.encode( (42'u8, @[1'u8, 2'u8, 3'u8], true) )
|
2021-12-01 10:46:45 +00:00
|
|
|
|
|
|
|
# decode values of different types
|
|
|
|
AbiDecoder.decode(bytes, uint8)
|
|
|
|
AbiDecoder.decode(bytes, UInt256)
|
|
|
|
AbiDecoder.decode(bytes, array[3, uint8])
|
|
|
|
AbiDecoder.decode(bytes, seq[uint8])
|
|
|
|
|
|
|
|
# decode tuples
|
|
|
|
AbiDecoder.decode(bytes, (uint32, bool, seq[byte]) )
|
2021-11-25 08:33:32 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
[1]: https://docs.soliditylang.org/en/latest/abi-spec.html
|
|
|
|
[2]: https://github.com/nim-lang/nimble
|