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

GEThttps://rest.metacoin.network:20923/block/

Response

200

successful operation

Body

*/*

string

Last block number

Request

JavaScriptCurlPython

const response = await fetch('https://rest.metacoin.network:20923/block/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

text

Get Block info and Transaction ID in block

GEThttps://rest.metacoin.network:20923/block/{block}

Path parameters

block*string

Block number or Block HASH

Response

200404

successful operation

Body

*/*

sninteger (integer)

Block number

idstring

block unique id

timestampinteger (UnixTimestamp (UTC))

block generation time.

transactionarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://rest.metacoin.network:20923/block/{block}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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

Get Transaction info

GEThttps://rest.metacoin.network:20923/transaction/{transaction_id}

Path parameters

transaction_id*string

Transaction ID

Response

200404

successful operation

Body

*/*

addressstring (Metacoin Address)

db_idstring

Contain this transaction's block_id

db_snstring (integer)

Contain this transaction's block no

idstring

Transaction's unique id

parametersarray of string

• Transaction parameters

• diffrent by type

timestampinteger (UnixTimestamp (UTC))

transaction generation time.

tokeninteger (UnixTimestamp (UTC))

transaction generation time.

typeenum

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

Chaincode Install or UpdateDataMigrationMRC020NewWalletSetBaseexchangeexchangeFeeexchangePairownerBurningownerIncreasestodexExchangestodexExchangePendingstodexExchangeRequeststodexRegisterstodexRequeststodexUnRegistertokenAddTargettokenBurningtokenIncreasetokenRegistertokenRemoveTargettoken_reservetransfer

validationCodestring (int32)

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

valuesobject

this address's data in Hyperledger fabric

Request

JavaScriptCurlPython

const response = await fetch('https://rest.metacoin.network:20923/transaction/{transaction_id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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