Dropil Chain API Documentation (1.0.0)

Dropil Chain Support: support@dropil.com URL: https://dropilchain.com

Introduction

Welcome to the Dropil Chain API documentation! These docs should contain all information needed to begin utilizing the public Dropil Chain API.

Transactions

Search, encode, or broadcast transactions.

Get a Tx by hash

get /txs/{hash}

Dropil Chain Mainnet

https://api.dropilchain.com/txs/{hash}

Dropil Chain Testnet

https://testnet-api.dropilchain.com/txs/{hash}

Retrieve a transaction using its hash.

path Parameters
hash
required
string
Example: BCBE20E8D46758B96AE5883B792858296AC06E51435490FBDCAE25A72B3CC76B

Tx hash

Responses

200

Tx with the provided hash

500

Internal Server Error

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hash": "D085138D913993919295FF4B0A9107F1F2CDE0D37A87CE0644E217CBF3B49656",
  • "height": 368,
  • "tx":
    {
    },
  • "result":
    {
    }
}

Search transactions

get /txs

Dropil Chain Mainnet

https://api.dropilchain.com/txs

Dropil Chain Testnet

https://testnet-api.dropilchain.com/txs

Search transactions by events.

query Parameters
message.action
string
Example: message.action=send

transaction events such as 'message.action=send' which results in the following endpoint: 'GET /txs?message.action=send'. note that each module documents its own events. look for xx_events.md in the corresponding cosmos-sdk/docs/spec directory

message.sender
string
Example: message.sender=drop12kc6agvc65aze7l359dguwcq7j5h0kw0k3ff59

transaction tags with sender: 'GET /txs?message.action=send&message.sender=drop12kc6agvc65aze7l359dguwcq7j5h0kw0k3ff59'

page
integer
Example: page=1

Page number

limit
integer
Example: limit=1

Maximum number of items per page

Responses

200

All txs matching the provided events

400

Invalid search events

500

Internal Server Error

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "total_count": 1,
  • "count": 1,
  • "page_number": 1,
  • "page_total": 1,
  • "limit": 30,
  • "txs":
    [
    ]
}

Broadcast a signed tx

post /txs

Dropil Chain Mainnet

https://api.dropilchain.com/txs

Dropil Chain Testnet

https://testnet-api.dropilchain.com/txs

Broadcast a signed tx to a full node

Request Body schema: application/json

The tx must be a signed StdTx. The supported broadcast modes include "block"(return after tx commit), "sync"(return afer CheckTx) and "async"(return right away).

tx
object (StdTx)
mode
string

Responses

200

Tx broadcasting result

500

Internal Server Error

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tx":
    {
    },
  • "mode": "block"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "check_tx":
    {
    },
  • "deliver_tx":
    {
    },
  • "hash": "EE5F3404034C524501629B56E0DDC38FAD651F04",
  • "height": 0
}

Encode a transaction to the Amino wire format

post /txs/encode

Dropil Chain Mainnet

https://api.dropilchain.com/txs/encode

Dropil Chain Testnet

https://testnet-api.dropilchain.com/txs/encode

Encode a transaction (signed or not) from JSON to base64-encoded Amino serialized bytes

Request Body schema: application/json

The tx to encode

tx
object (StdTx)

Responses

200

The tx was successfully decoded and re-encoded

400

The tx was malformated

500

Server internal error

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tx":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tx": "The base64-encoded Amino-serialized bytes for the tx"
}

Decode a transaction from the Amino wire format

post /txs/decode

Dropil Chain Mainnet

https://api.dropilchain.com/txs/decode

Dropil Chain Testnet

https://testnet-api.dropilchain.com/txs/decode

Decode a transaction (signed or not) from base64-encoded Amino serialized bytes to JSON

Request Body schema: application/json

The tx to decode

tx
string

Responses

200

The tx was successfully decoded

400

The tx was malformated

500

Server internal error

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tx": "SvBiXe4KPqijYZoKFFHEzJ8c2HPAfv2EFUcIhx0yPagwEhTy0vPA+GGhCEslKXa4Af0uB+mfShoMCgVzdGFrZRIDMTAwEgQQwJoM"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "msg":
    [
    ],
  • "fee":
    {
    },
  • "memo": "string",
  • "signature":
    {
    }
}

Tendermint RPC

Tendermint APIs, such as query blocks, transactions and validatorset

Syncing state of node

get /syncing

Dropil Chain Mainnet

https://api.dropilchain.com/syncing

Dropil Chain Testnet

https://testnet-api.dropilchain.com/syncing

Get if the node is currently syning with other nodes

Responses

200

Node syncing status

500

Server internal error

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "syncing": true
}

Get the latest block

get /blocks/latest

Dropil Chain Mainnet

https://api.dropilchain.com/blocks/latest

Dropil Chain Testnet

https://testnet-api.dropilchain.com/blocks/latest

Responses

200

The latest block

500

Server internal error

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "block_meta":
    {
    },
  • "block":
    {