gramcoinorg/mining-pool

Gram Mining Pool Backend API

This API allows miners to interact with the Gram Mining Pool backend to fetch tasks and submit solutions.

Telegram Developers Chat | Telegram News Channel | Pool Official Web-site

API Host

https://api-pool.gramcoin.org

Get Task

Retrieve simplified tasks associated with a miner's address.

Request

GET /v2/task/:address

Params

• :address - The miner's address in the TON network.

Headers

• X-MINER-VERSION (mandatory): EXTERNAL-bc10c1fa

Response

• 200 OK for successful request, with the following body:

{
  task: {
    id: string,
    seed: string,
    complexity: string,
    pool_address: string,
  } | null,
  tick: number
}

• 400 Bad Request for errors, with the following body:

{
  error: string
}

Response Fields

• task: Task details (nullable).
• • id: Task identifier.
• • seed: Seed for task generation (DEC).
• • complexity: Task complexity (DEC).
• • pool_address: Address of the mining pool (for calculation).
• tick: Time in milliseconds until the next request.

Submit Solution

Submit a solution to a task associated with a miner's address.

POST /v2/solution/:address

Params

• :address - The miner's address in the TON network.

Headers

• X-MINER-VERSION (mandatory): EXTERNAL-bc10c1fa

Body

{
  id: string,
  solution: string,
}

• id: Task identifier.
• solution: Solution in hexadecimal format.

Response

• 200 OK for successful submission.
• 400 Bad Request for errors, with the following body:

{
  error: string
}