Block and transaction

Block information

Good to know: All the methods shown below are synced to an example Swagger file URL and are kept up to date automatically with changes to the API.

Get last block info

get

/block/

Responses

200

successful operation

*/*

stringOptional

Last block number

get/block/

GET /block/ HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*

200

successful operation

text

Get Block info and Transaction ID in block

get

/block/{block}

Path parameters

blockstringRequired

Block number or Block HASH

Responses

200

successful operation

*/*

sninteger · integerOptional

Block number

idstringOptional

block unique id

timestampinteger · UnixTimestamp (UTC)Optional

block generation time.

404

Block not found

get/block/{block}

GET /block/{block} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*

{
  "sn": 1,
  "id": "text",
  "timestamp": 1,
  "transaction": [
    {
      "id": "text",
      "timestamp": 1
    }
  ]
}

Get Transaction info

get

/transaction/{transaction_id}

Path parameters

transaction_idstringRequired

Transaction ID

Responses

200

successful operation

*/*

addressstring · Metacoin AddressOptional

db_idstringOptional

Contain this transaction's block_id

db_snstring · integerOptional

Contain this transaction's block no

idstringOptional

Transaction's unique id

parametersstring[]Optional

• Transaction parameters

• diffrent by type

timestampinteger · UnixTimestamp (UTC)Optional

transaction generation time.

tokeninteger · UnixTimestamp (UTC)Optional

transaction generation time.

typestring · enumOptional

Meaning of parameters by type

1. Chaincode Install or Update

• Chaincode upgrade

2. DataMigration

• Hyperledger Data format or value fix

3. MRC020

• Delayed open

4. NewWallet

• Create new address

5. SetBase

• Set base token for MRC040 protocol
  1. base token id
  2. target token id

6. exchange, exchangePair, exchangeFee, exchangeFeePair

• token exchange
  1. from address
  2. Amount "from address" sent to "to address"
  3. Token id "from address" sent to "to address"
  4. Address receiving fee of from address
  5. Fee paid by from address
  6. Token ID of fee paid by from address
  7. from address's tag
  8. from address's memo
  9. from address's signature
  10. from address
  11. Amount "from address" sent to "to address"
  12. Token id "from address" sent to "to address"
  13. Address receiving fee of to address
  14. Fee paid by to address
  15. Token ID of fee paid by to address
  16. to address's tag
  17. to address's memo
  18. to address's signature

7. tokenUpdate

• token update
  1. token id
  2. url
  3. info
  4. image
  5. signature

8. ownerBurning, tokenBurning

• token burning
  1. token id
  2. Burning amount
  3. Signature

9. ownerIncrease, tokenIncrease

• token increase
  1. token id
  2. Increase amount
  3. Signature

10. tokenRegister

• same as token create.

11. token_reserve

    • token receive at token create
      1. token sender(token owner)
      2. receive address
      3. receive amount
      4. token id

12. transfer

    • token transfer
      1. from address
      2. to address
      3. amount
      4. token id
      5. signature
      6. unlock date
      7. tag
      8. memo

13. stodexExchange, stodexExchangePending, stodexExchangeRequest, stodexRegister, stodexRequest, stodexUnRegister

• for MRC040
• sorry, not yet fixed

Possible values:

validationCodestring · int32Optional

• 0 : success transaction
• not 0 : Ignore this transaction(see detail - https://github.com/hyperledger/fabric/blob/v1.0.0/protos/peer/transaction.proto#L125)

404

Transaction not found

get/transaction/{transaction_id}

GET /transaction/{transaction_id} HTTP/1.1
Host: rest.metacoin.network:20923
Accept: */*

{
  "address": "text",
  "db_id": "text",
  "db_sn": "text",
  "id": "text",
  "parameters": [
    "text"
  ],
  "timestamp": 1,
  "token": 1,
  "type": "Chaincode Install or Update",
  "validationCode": "text",
  "values": {
    "addinfo": "text",
    "balance": [
      {
        "token": "text",
        "balance": "text",
        "unlockdate": 1
      }
    ],
    "password": "text",
    "pending": [
      {}
    ],
    "regdate": 1
  }
}