spacemeshos / svm

SVM - Spacemesh Virtual Machine
https://spacemesh.io
MIT License
85 stars 14 forks source link

Implement host function: `svm_tx_amount` #488

Open YaronWittenstein opened 2 years ago

YaronWittenstein commented 2 years ago

Depends on #487

We need to ask the Host for the amount value supplied in the Transaction.

One classic usage is tracking how much money the current executing Account has been funded. So each time an Account gets funding, it will execute some piece of code (see SVM SDK fundable hooks feature - similar to the payable of Solidity)

That code will ask the Host for the current transaction value to update some Storage variable of itself.

Implementation Proposal

The host function signature should look probably like this:

fn tx_amount(env: &FuncEnv) -> u64 {
  // ...
}

The amount will be taken from the Envelope.

Fundable Hooks

Fundable hooks are SVM SDK mechanisms to share common pieces of code between different #[endpoint]. When an endpoint wants to use an existing fundable hook, it should add this annotation: #[fundable(FUNDABLE_HOOK_NAME)]

Links:

Open Question