Skip to main content

Accelerator RPC API

embedded.accelerator​

embedded.accelerator.getAll​

This API call will return a paginated list of all Accelerator-Z projects, sorted by last update timestamp.

Request​

2 parameters:

  • first parameter of type number that represents the page index
  • second parameter of type number that represents the page size
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "embedded.accelerator.getAll",
    "params": [0, 10]
}

Response​

  • count - total number of projects
  • list - array of project objects containing:
    • id - project hash identifier
    • owner - address of project owner
    • name - project name
    • description - project description
    • url - project URL
    • znnFundsNeeded - ZNN funds requested
    • qsrFundsNeeded - QSR funds requested
    • creationTimestamp - creation timestamp
    • lastUpdateTimestamp - last update timestamp
    • status - project status
    • phaseIds - array of phase hash identifiers
    • votes - voting information
    • phases - array of phase objects
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "count": 185,
        "list": [
            {
                "id": "50ef67972bf4d3c33a5a8964d864be7fae198145aa92b4a6145697b1159d277a",
                "owner": "z1qrjvurstsasg45m7meuzdnngj3utrlczk2drru",
                "name": "HYPERQUBE_Z LAUNCH GENESIS",
                "description": "Download the genesis file and run the hyperqube_z node.",
                "url": "https://forum.hypercore.one/t/how-to-deploy-a-hqz-pillar/586",
                "znnFundsNeeded": "1000000000",
                "qsrFundsNeeded": "10000000000",
                "creationTimestamp": 1739467650,
                "lastUpdateTimestamp": 1739467650,
                "status": 3,
                "phaseIds": [],
                "votes": {
                    "id": "50ef67972bf4d3c33a5a8964d864be7fae198145aa92b4a6145697b1159d277a",
                    "total": 8,
                    "yes": 8,
                    "no": 0
                },
                "phases": []
            }
        ]
    }
}

embedded.accelerator.getProjectById​

This API call will return details about a specific Accelerator-Z project by its hash identifier.

Request​

One parameter of type string that represents the project hash.

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "embedded.accelerator.getProjectById",
    "params": ["50ef67972bf4d3c33a5a8964d864be7fae198145aa92b4a6145697b1159d277a"]
}

Response​

Same project object structure as in getAll response.

{
    "jsonrpc": "2.0",
    "id": 2,
    "result": {
        "id": "50ef67972bf4d3c33a5a8964d864be7fae198145aa92b4a6145697b1159d277a",
        "owner": "z1qrjvurstsasg45m7meuzdnngj3utrlczk2drru",
        "name": "HYPERQUBE_Z LAUNCH GENESIS",
        "description": "Download the genesis file and run the hyperqube_z node.",
        "url": "https://forum.hypercore.one/t/how-to-deploy-a-hqz-pillar/586",
        "znnFundsNeeded": "1000000000",
        "qsrFundsNeeded": "10000000000",
        "creationTimestamp": 1739467650,
        "lastUpdateTimestamp": 1739467650,
        "status": 3,
        "phaseIds": [],
        "votes": {
            "id": "50ef67972bf4d3c33a5a8964d864be7fae198145aa92b4a6145697b1159d277a",
            "total": 8,
            "yes": 8,
            "no": 0
        },
        "phases": []
    }
}

embedded.accelerator.getPhaseById​

This API call will return details about a specific project phase by its hash identifier.

Request​

One parameter of type string that represents the phase hash.

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "embedded.accelerator.getPhaseById",
    "params": ["d24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5"]
}

Response​

  • Phase object containing:
    • id - phase hash identifier
    • projectId - parent project hash
    • name - phase name
    • description - phase description
    • url - phase URL
    • znnFundsNeeded - ZNN funds requested for phase
    • qsrFundsNeeded - QSR funds requested for phase
    • creationTimestamp - creation timestamp
    • acceptedTimestamp - acceptance timestamp
    • status - phase status
{
    "jsonrpc": "2.0",
    "id": 3,
    "result": {
        "id": "d24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5",
        "projectId": "c24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5",
        "name": "Phase 1",
        "description": "First phase of the project",
        "url": "https://example.com/phase1",
        "znnFundsNeeded": 5000000000,
        "qsrFundsNeeded": 50000000000,
        "creationTimestamp": 1640200000,
        "acceptedTimestamp": 0,
        "status": 0
    }
}

embedded.accelerator.getVoteBreakdown​

This API call will return the voting breakdown for a given project or phase.

Request​

One parameter of type string that represents the project or phase hash.

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "embedded.accelerator.getVoteBreakdown",
    "params": ["c24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5"]
}

Response​

  • id - hash identifier
  • total - total number of votes
  • yes - number of yes votes
  • no - number of no votes
  • voteDetails - array of individual pillar votes
{
    "jsonrpc": "2.0",
    "id": 4,
    "result": {
        "id": "c24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5",
        "total": 10,
        "yes": 8,
        "no": 2,
        "voteDetails": [
            {
                "pillarName": "Pillar1",
                "vote": 0
            },
            {
                "pillarName": "Pillar2", 
                "vote": 1
            }
        ]
    }
}

embedded.accelerator.getPillarVotes​

This API call will return the votes of a specific pillar for given project/phase hashes.

Request​

2 parameters:

  • first parameter of type string that represents the pillar name
  • second parameter of type array that contains hash identifiers
{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "embedded.accelerator.getPillarVotes",
    "params": ["Pillar1", ["c24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5"]]
}

Response​

Array of pillar vote objects:

  • id - hash identifier
  • pillarName - name of the pillar
  • vote - vote value (0 = yes, 1 = no, 2 = abstain)
{
    "jsonrpc": "2.0",
    "id": 5,
    "result": [
        {
            "id": "c24a5a6166c8948aba3e8a573e7173faf3d88e48c9798b1b67b7e61ae8552ed5",
            "pillarName": "Pillar1",
            "vote": 0
        }
    ]
}