Core gRPC Endpoints

Detailed core gRPC endpoint reference

📘

gRPC Overview

Please refer to the gRPC Overview for details regarding running the examples shown below, encoding/decoding the request/response data, and clients available for several languages.

Endpoint Details

getStatus

Returns: Status information from the Core chain
Parameters: None

Example Request and Response

Request (gRPCurl)

grpcurl -plaintext -proto protos/core.proto \
  seed.evonet.networks.dash.org:3010 \
  org.dash.platform.dapi.v0.Core/getStatus

JavaScript (dapi-client)

const DAPIClient = require('@dashevo/dapi-client');

const client = new DAPIClient({
  seeds: [{
    service: 'seed-1.evonet.networks.dash.org',
    port: 3000
  }],
});

client.getStatus().then((response) => {
  console.log(response);
});

Response

{
  "coreVersion": 150000,
  "protocolVersion": 70216,
  "blocks": 6056,
  "connections": 62,
  "difficulty": 0.001477193138737096,
  "relayFee": 1e-05,
  "network": "testnet"
}

Response (dapi-client)

{
  coreVersion: 150000,
  protocolVersion: 70216,
  blocks: 6056,
  timeOffset: 0,
  connections: 65,
  proxy: '',
  difficulty: 0.001477193138737096,
  testnet: false,
  relayFee: 0.00001,
  errors: '',
  network: 'testnet'
}

getBlock

Returns: A raw block
Parameters:

Name	Type	Required	Description
One of the following:
hash	Bytes	No	Return the block matching the block hash provided
height	Integer	No	Return the block matching the block height provided

Example Request and Response

Request (gRPCurl)

grpcurl -plaintext -proto protos/core.proto \
  -d '{
    "height":1
    }' \
  seed.evonet.networks.dash.org:3010 \
  org.dash.platform.dapi.v0.Core/getBlock

📘

Block Encoding

Note: The response block data is Base64 encoded

Response

{
  "block": "BAAAAC498j7sXNaobt1QlTkCjiw6PcBTFeso8rqkMhjKCAAAGIrsfCKw44jdFcMK7FOSYlv2BLmgl0VVcKFTyQDdWgS6loBU//9/IAEAAAABAQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP////8PUQ1kZXZuZXQtZXZvbmV0/////wEA8gUqAQAAAAFqAAAAAA=="
}

sendTransaction

Returns: The transaction id (TXID) if successful
Parameters:

Name	Type	Required	Description
transaction	Bytes	Yes	A raw transaction
allow_high_fees	Boolean	No	Enables bypassing the high fee check
bypass_limits	Boolean	No

Example Request and Response

Request (gRPCurl)

grpcurl -plaintext -proto protos/core.proto \
  -d '{
    "transaction": "03000000014f83880b387e1d4a639f8dd59083ab68f464516a060e4725cc1530a0ee2c3d41000000006b483045022100e7ea589971130f6221ec129b66696ecdd359576b7421e8ee5ab0c7e8c4dc3c460220075c25bd0384148de5636af8bc16f4cc271156d20a3eae26e6b590bfc84033d2012103a65caff6ca4c0415a3ac182dfc2a6d3a4dceb98e8b831e71501df38aa156f2c1ffffffff02204e0000000000001976a91409cf4b155dd5ca22979c1390df14aaaa1009bbee88ac44701a3d050000001976a91416b93a3b9168a20605cc3cda62f6135a3baa531a88ac00000000"
    }' \
  seed.evonet.networks.dash.org:3010 \
  org.dash.platform.dapi.v0.Core/sendTransaction

Response

0f8409a5239150bc9a12c2d3b9a430dcc515ef562906a46e2bfb3ba418d8c9e3

getTransaction

Returns: A raw transaction
Parameters:

Name	Type	Required	Description
id	String	Yes	A transaction id (TXID)

Example Request and Response

Request (gRPCurl)

grpcurl -plaintext -proto protos/core.proto \
  -d '{
    "id":"0f8409a5239150bc9a12c2d3b9a430dcc515ef562906a46e2bfb3ba418d8c9e3"
    }' \
  seed.evonet.networks.dash.org:3010 \
  org.dash.platform.dapi.v0.Core/getTransaction

📘

Transaction Encoding

Note: The response transaction data is Base64 encoded

Response

{
  "transaction": "AwAAAAFPg4gLOH4dSmOfjdWQg6to9GRRagYORyXMFTCg7iw9QQAAAABrSDBFAiEA5+pYmXETD2Ih7BKbZmluzdNZV2t0IejuWrDH6MTcPEYCIAdcJb0DhBSN5WNq+LwW9MwnEVbSCj6uJua1kL/IQDPSASEDplyv9spMBBWjrBgt/CptOk3OuY6Lgx5xUB3ziqFW8sH/////AiBOAAAAAAAAGXapFAnPSxVd1coil5wTkN8UqqoQCbvuiKxEcBo9BQAAABl2qRQWuTo7kWiiBgXMPNpi9hNaO6pTGoisAAAAAA=="
}

Code Reference

Implementation details related to the information on this page can be found in:

• The [DAPI repository]((https://github.com/dashevo/dapi) lib/grpcServer/handlers/core folder
• The DAPI-gRPC repository protos folder