2022-01-20 11:56:18 +00:00
|
|
|
import std/macros
|
|
|
|
import pkg/chronos
|
|
|
|
import pkg/contractabi
|
|
|
|
import ./basics
|
|
|
|
import ./provider
|
2022-01-25 16:17:43 +00:00
|
|
|
import ./signer
|
2022-02-01 14:49:36 +00:00
|
|
|
import ./events
|
2022-02-02 15:56:37 +00:00
|
|
|
import ./fields
|
2022-01-20 11:56:18 +00:00
|
|
|
|
|
|
|
export basics
|
|
|
|
export provider
|
2022-02-01 14:49:36 +00:00
|
|
|
export events
|
2022-01-20 11:56:18 +00:00
|
|
|
|
|
|
|
type
|
|
|
|
Contract* = ref object of RootObj
|
|
|
|
provider: Provider
|
2022-01-25 16:17:43 +00:00
|
|
|
signer: ?Signer
|
2022-01-20 11:56:18 +00:00
|
|
|
address: Address
|
2023-04-18 15:28:28 +00:00
|
|
|
TransactionOverrides* = ref object of RootObj
|
2022-07-12 10:43:56 +00:00
|
|
|
nonce*: ?UInt256
|
2022-07-12 18:43:27 +00:00
|
|
|
chainId*: ?UInt256
|
2022-07-12 10:43:56 +00:00
|
|
|
gasPrice*: ?UInt256
|
2022-07-12 18:43:27 +00:00
|
|
|
maxFee*: ?UInt256
|
|
|
|
maxPriorityFee*: ?UInt256
|
2022-07-12 10:43:56 +00:00
|
|
|
gasLimit*: ?UInt256
|
2023-04-18 15:28:28 +00:00
|
|
|
CallOverrides* = ref object of TransactionOverrides
|
|
|
|
blockTag*: ?BlockTag
|
2022-07-12 10:43:56 +00:00
|
|
|
|
2022-01-25 09:25:09 +00:00
|
|
|
ContractError* = object of EthersError
|
2022-05-18 13:14:39 +00:00
|
|
|
Confirmable* = ?TransactionResponse
|
2022-02-02 15:56:37 +00:00
|
|
|
EventHandler*[E: Event] = proc(event: E) {.gcsafe, upraises:[].}
|
2022-01-20 11:56:18 +00:00
|
|
|
|
2022-01-26 09:31:54 +00:00
|
|
|
func new*(ContractType: type Contract,
|
|
|
|
address: Address,
|
|
|
|
provider: Provider): ContractType =
|
|
|
|
ContractType(provider: provider, address: address)
|
|
|
|
|
|
|
|
func new*(ContractType: type Contract,
|
|
|
|
address: Address,
|
|
|
|
signer: Signer): ContractType =
|
|
|
|
ContractType(signer: some signer, provider: signer.provider, address: address)
|
|
|
|
|
2022-01-26 11:23:30 +00:00
|
|
|
func connect*[T: Contract](contract: T, provider: Provider | Signer): T =
|
|
|
|
T.new(contract.address, provider)
|
|
|
|
|
2022-01-25 16:17:43 +00:00
|
|
|
func provider*(contract: Contract): Provider =
|
|
|
|
contract.provider
|
|
|
|
|
|
|
|
func signer*(contract: Contract): ?Signer =
|
|
|
|
contract.signer
|
|
|
|
|
|
|
|
func address*(contract: Contract): Address =
|
|
|
|
contract.address
|
|
|
|
|
2022-01-20 11:56:18 +00:00
|
|
|
template raiseContractError(message: string) =
|
|
|
|
raise newException(ContractError, message)
|
|
|
|
|
2022-01-26 09:31:54 +00:00
|
|
|
proc createTransaction(contract: Contract,
|
|
|
|
function: string,
|
2022-07-11 13:15:01 +00:00
|
|
|
parameters: tuple,
|
2023-04-18 15:28:28 +00:00
|
|
|
overrides = TransactionOverrides()): Transaction =
|
2022-01-20 11:56:18 +00:00
|
|
|
let selector = selector(function, typeof parameters).toArray
|
2022-01-26 09:31:54 +00:00
|
|
|
let data = @selector & AbiEncoder.encode(parameters)
|
2022-07-12 10:43:56 +00:00
|
|
|
Transaction(
|
|
|
|
to: contract.address,
|
|
|
|
data: data,
|
2022-07-12 18:43:27 +00:00
|
|
|
nonce: overrides.nonce,
|
|
|
|
chainId: overrides.chainId,
|
2022-07-12 10:43:56 +00:00
|
|
|
gasPrice: overrides.gasPrice,
|
2022-07-12 18:43:27 +00:00
|
|
|
maxFee: overrides.maxFee,
|
|
|
|
maxPriorityFee: overrides.maxPriorityFee,
|
2022-07-12 10:43:56 +00:00
|
|
|
gasLimit: overrides.gasLimit,
|
|
|
|
)
|
2022-01-20 11:56:18 +00:00
|
|
|
|
2022-06-09 13:30:34 +00:00
|
|
|
proc decodeResponse(T: type, multiple: static bool, bytes: seq[byte]): T =
|
|
|
|
when multiple:
|
|
|
|
without decoded =? AbiDecoder.decode(bytes, T):
|
|
|
|
raiseContractError "unable to decode return value as " & $T
|
|
|
|
return decoded
|
|
|
|
else:
|
|
|
|
return decodeResponse((T,), true, bytes)[0]
|
2022-01-20 11:56:18 +00:00
|
|
|
|
2023-04-18 15:28:28 +00:00
|
|
|
proc call(provider: Provider,
|
|
|
|
transaction: Transaction,
|
|
|
|
overrides: TransactionOverrides): Future[seq[byte]] =
|
|
|
|
if overrides of CallOverrides and
|
|
|
|
blockTag =? CallOverrides(overrides).blockTag:
|
|
|
|
provider.call(transaction, blockTag)
|
|
|
|
else:
|
|
|
|
provider.call(transaction)
|
|
|
|
|
2022-04-10 20:21:59 +00:00
|
|
|
proc call(contract: Contract,
|
|
|
|
function: string,
|
|
|
|
parameters: tuple,
|
2023-04-18 15:28:28 +00:00
|
|
|
overrides = TransactionOverrides()) {.async.} =
|
2023-06-13 14:24:59 +00:00
|
|
|
var transaction = createTransaction(contract, function, parameters, overrides)
|
|
|
|
|
|
|
|
if signer =? contract.signer and transaction.sender.isNone:
|
|
|
|
transaction.sender = some(await signer.getAddress())
|
|
|
|
|
2023-04-18 15:28:28 +00:00
|
|
|
discard await contract.provider.call(transaction, overrides)
|
2022-01-25 16:17:43 +00:00
|
|
|
|
2022-01-26 09:31:54 +00:00
|
|
|
proc call(contract: Contract,
|
2022-01-25 16:17:43 +00:00
|
|
|
function: string,
|
2022-01-26 09:31:54 +00:00
|
|
|
parameters: tuple,
|
2022-04-10 20:21:59 +00:00
|
|
|
ReturnType: type,
|
2022-06-09 13:30:34 +00:00
|
|
|
returnMultiple: static bool,
|
2023-04-18 15:28:28 +00:00
|
|
|
overrides = TransactionOverrides()): Future[ReturnType] {.async.} =
|
2023-06-13 14:24:59 +00:00
|
|
|
var transaction = createTransaction(contract, function, parameters, overrides)
|
|
|
|
|
|
|
|
if signer =? contract.signer and transaction.sender.isNone:
|
|
|
|
transaction.sender = some(await signer.getAddress())
|
|
|
|
|
2023-04-18 15:28:28 +00:00
|
|
|
let response = await contract.provider.call(transaction, overrides)
|
2022-06-09 13:30:34 +00:00
|
|
|
return decodeResponse(ReturnType, returnMultiple, response)
|
2022-01-25 16:17:43 +00:00
|
|
|
|
2022-07-11 13:15:01 +00:00
|
|
|
proc send(contract: Contract,
|
|
|
|
function: string,
|
|
|
|
parameters: tuple,
|
2023-04-18 15:28:28 +00:00
|
|
|
overrides = TransactionOverrides()):
|
2022-07-11 13:15:01 +00:00
|
|
|
Future[?TransactionResponse] {.async.} =
|
2022-01-26 09:31:54 +00:00
|
|
|
if signer =? contract.signer:
|
2022-07-11 13:15:01 +00:00
|
|
|
let transaction = createTransaction(contract, function, parameters, overrides)
|
2022-01-26 09:31:54 +00:00
|
|
|
let populated = await signer.populateTransaction(transaction)
|
2022-05-17 02:34:22 +00:00
|
|
|
let txResp = await signer.sendTransaction(populated)
|
|
|
|
return txResp.some
|
2022-01-26 09:31:54 +00:00
|
|
|
else:
|
|
|
|
await call(contract, function, parameters)
|
2022-05-17 02:34:22 +00:00
|
|
|
return TransactionResponse.none
|
2022-01-20 11:56:18 +00:00
|
|
|
|
2022-01-26 09:31:54 +00:00
|
|
|
func getParameterTuple(procedure: NimNode): NimNode =
|
2022-01-20 11:56:18 +00:00
|
|
|
let parameters = procedure[3]
|
|
|
|
var tupl = newNimNode(nnkTupleConstr, parameters)
|
|
|
|
for parameter in parameters[2..^1]:
|
|
|
|
for name in parameter[0..^3]:
|
|
|
|
tupl.add name
|
|
|
|
return tupl
|
|
|
|
|
2022-01-25 16:17:43 +00:00
|
|
|
func isConstant(procedure: NimNode): bool =
|
|
|
|
let pragmas = procedure[4]
|
|
|
|
for pragma in pragmas:
|
|
|
|
if pragma.eqIdent "view":
|
|
|
|
return true
|
|
|
|
elif pragma.eqIdent "pure":
|
|
|
|
return true
|
|
|
|
false
|
|
|
|
|
2022-06-09 13:30:34 +00:00
|
|
|
func isMultipleReturn(returnType: NimNode): bool =
|
|
|
|
(returnType.kind == nnkPar and returnType.len > 1) or
|
|
|
|
(returnType.kind == nnkTupleConstr) or
|
|
|
|
(returnType.kind == nnkTupleTy)
|
|
|
|
|
2022-07-11 13:15:01 +00:00
|
|
|
func addOverrides(procedure: var NimNode) =
|
|
|
|
procedure[3].add(
|
|
|
|
newIdentDefs(
|
|
|
|
ident("overrides"),
|
|
|
|
newEmptyNode(),
|
2023-04-18 15:28:28 +00:00
|
|
|
quote do: TransactionOverrides()
|
2022-07-11 13:15:01 +00:00
|
|
|
)
|
|
|
|
)
|
|
|
|
|
2022-01-20 11:56:18 +00:00
|
|
|
func addContractCall(procedure: var NimNode) =
|
2022-01-26 09:31:54 +00:00
|
|
|
let contract = procedure[3][1][0]
|
|
|
|
let function = $basename(procedure[0])
|
|
|
|
let parameters = getParameterTuple(procedure)
|
2022-06-09 13:30:34 +00:00
|
|
|
let returnType = procedure[3][0]
|
|
|
|
let returnMultiple = returnType.isMultipleReturn.newLit
|
2022-05-23 14:20:51 +00:00
|
|
|
|
2022-07-11 13:15:01 +00:00
|
|
|
procedure.addOverrides()
|
|
|
|
|
2022-05-23 14:20:51 +00:00
|
|
|
func call: NimNode =
|
2022-06-09 13:30:34 +00:00
|
|
|
if returnType.kind == nnkEmpty:
|
2022-05-23 14:20:51 +00:00
|
|
|
quote:
|
2023-04-18 15:28:28 +00:00
|
|
|
await call(`contract`, `function`, `parameters`, overrides)
|
2022-05-23 14:20:51 +00:00
|
|
|
else:
|
|
|
|
quote:
|
2022-06-09 13:30:34 +00:00
|
|
|
return await call(
|
2023-04-18 15:28:28 +00:00
|
|
|
`contract`, `function`, `parameters`, `returnType`, `returnMultiple`, overrides)
|
2022-05-23 14:20:51 +00:00
|
|
|
|
|
|
|
func send: NimNode =
|
2022-06-09 13:30:34 +00:00
|
|
|
if returnType.kind == nnkEmpty:
|
2022-05-23 14:20:51 +00:00
|
|
|
quote:
|
2022-07-11 13:15:01 +00:00
|
|
|
discard await send(`contract`, `function`, `parameters`, overrides)
|
2022-05-23 14:20:51 +00:00
|
|
|
else:
|
|
|
|
quote:
|
|
|
|
when typeof(result) isnot Confirmable:
|
|
|
|
{.error: "unexpected return type, missing {.view.} or {.pure.} ?".}
|
2022-07-11 13:15:01 +00:00
|
|
|
return await send(`contract`, `function`, `parameters`, overrides)
|
2022-05-23 14:20:51 +00:00
|
|
|
|
2022-01-26 09:31:54 +00:00
|
|
|
procedure[6] =
|
|
|
|
if procedure.isConstant:
|
2022-05-23 14:20:51 +00:00
|
|
|
call()
|
2022-01-26 09:31:54 +00:00
|
|
|
else:
|
2022-05-23 14:20:51 +00:00
|
|
|
send()
|
2022-01-20 11:56:18 +00:00
|
|
|
|
|
|
|
func addFuture(procedure: var NimNode) =
|
|
|
|
let returntype = procedure[3][0]
|
2022-01-25 16:17:43 +00:00
|
|
|
if returntype.kind != nnkEmpty:
|
2022-01-26 09:31:54 +00:00
|
|
|
procedure[3][0] = quote: Future[`returntype`]
|
2022-01-20 11:56:18 +00:00
|
|
|
|
|
|
|
func addAsyncPragma(procedure: var NimNode) =
|
|
|
|
let pragmas = procedure[4]
|
|
|
|
if pragmas.kind == nnkEmpty:
|
|
|
|
procedure[4] = newNimNode(nnkPragma)
|
|
|
|
procedure[4].add ident("async")
|
|
|
|
|
|
|
|
macro contract*(procedure: untyped{nkProcDef|nkMethodDef}): untyped =
|
2022-01-26 09:31:54 +00:00
|
|
|
|
2022-01-20 11:56:18 +00:00
|
|
|
let parameters = procedure[3]
|
|
|
|
let body = procedure[6]
|
2022-01-26 09:31:54 +00:00
|
|
|
|
|
|
|
parameters.expectMinLen(2) # at least return type and contract instance
|
2022-01-20 11:56:18 +00:00
|
|
|
body.expectKind(nnkEmpty)
|
2022-01-26 09:31:54 +00:00
|
|
|
|
2022-01-20 11:56:18 +00:00
|
|
|
var contractcall = copyNimTree(procedure)
|
|
|
|
contractcall.addContractCall()
|
|
|
|
contractcall.addFuture()
|
|
|
|
contractcall.addAsyncPragma()
|
|
|
|
contractcall
|
2022-01-26 09:31:54 +00:00
|
|
|
|
|
|
|
template view* {.pragma.}
|
|
|
|
template pure* {.pragma.}
|
2022-02-02 15:56:37 +00:00
|
|
|
|
|
|
|
proc subscribe*[E: Event](contract: Contract,
|
|
|
|
_: type E,
|
|
|
|
handler: EventHandler[E]):
|
|
|
|
Future[Subscription] =
|
|
|
|
|
|
|
|
let topic = topic($E, E.fieldTypes).toArray
|
|
|
|
let filter = Filter(address: contract.address, topics: @[topic])
|
|
|
|
|
|
|
|
proc logHandler(log: Log) {.upraises: [].} =
|
|
|
|
if event =? E.decode(log.data, log.topics):
|
|
|
|
handler(event)
|
|
|
|
|
|
|
|
contract.provider.subscribe(filter, logHandler)
|
2023-06-29 08:11:13 +00:00
|
|
|
|
|
|
|
proc confirm*(tx: Future[?TransactionResponse],
|
|
|
|
confirmations: int = EthersDefaultConfirmations,
|
|
|
|
timeout: int = EthersReceiptTimeoutBlks):
|
|
|
|
Future[TransactionReceipt] {.async.} =
|
|
|
|
## Convenience method that allows confirm to be chained to a contract
|
|
|
|
## transaction, eg:
|
|
|
|
## `await token.connect(signer0)
|
|
|
|
## .mint(accounts[1], 100.u256)
|
|
|
|
## .confirm(3)`
|
|
|
|
|
|
|
|
without response =? (await tx):
|
|
|
|
raise newException(
|
|
|
|
EthersError,
|
|
|
|
"Transaction hash required. Possibly was a call instead of a send?"
|
|
|
|
)
|
|
|
|
|
|
|
|
return await response.confirm(confirmations, timeout)
|