Add a new voucher

The DApp backend can call this method to add a new voucher when processing an advance-state request. Vouchers are collateral effects actionable in the blockchain. Between calls to the finish method, the voucher method can be called at least 32k times.

The returned value is the index of the voucher for the current advance-state request. In other words, the index counting restarts at every request.

application/json

Request Body

• address string

  Ethereum address.

• payload string

  Payload in the Ethereum hex binary format. The first two characters are '0x' followed by pairs of hexadecimal numbers that correspond to one byte. For instance, '0xdeadbeef' corresponds to a payload with length 4 and bytes 222, 173, 190, 175. An empty payload is represented by the string '0x'.

Responses

• 200
• default

---

Created the voucher.

application/json

• Schema
• Example (from schema)

---

Schema

• index uint64

  Position in the Merkle tree.

{
  "index": 0
}

Error response.

text/plain

• Schema

---

Schema

• string

  Detailed error message.