v1

latestOpenAPI 3.0.02026-07-17151326.9 KB
Anchor

Writes a Sidetree transaction to the underlying anchor.

post/anchor/transactions

Request body

anchor_stringstring

The string to be written to the anchor for this transaction.

minimum_feestring

A number representing the minimum transaction fee to be paid to write this transaction to the anchor. The actual fee is dynamically calculated and can be higher than this amount (but not lower).

Example request

{
  "minimum_fee": 200000,
  "anchor_string": "QmbJGU4wNti6vNMGMosXaHbeMHGu9PkAUZtVBb2s2Vyq5d"
}

Response

Success

transaction_numbernumber

A monotonically increasing number (need NOT be by 1) that identifies a Sidtree transaction.

transaction_timenumber

The logical anchor time this transaction is anchored. Used for protocol version selection.

transaction_time_hashstring

The hash associated with the transaction time.

anchor_stringstring

The string written to the anchor for this transaction.

transaction_fee_paidstring

A number representing the fee paid for this transaction.

normalized_transaction_feestring

A number representing the normalized transaction fee used for proof-of-fee calculation.

writerstring

A string representing the writer of the transaction. Used in the value time lock calculations.

Example response

{
  "transaction_number": 89,
  "transaction_time": 545236,
  "transaction_time_hash": "0000000000000000002352597f8ec45c56ad19994808e982f5868c5ff6cfef2e",
  "anchor_string": "QmWd5PH6vyRH5kMdzZRPBnf952dbR4av3Bd7B2wBqMaAcf",
  "transaction_fee_paid": 40000,
  "normalized_transaction_fee": 100,
  "writer": "0af7eccefa3aaa37421914923b4a2034ed5a0ad0"
}