Build on Promx

Everything you need to build on the promise protocol.

๐Ÿ–ฅ๏ธ

Run a Node

Run a node that keeps its own copy of the PromX chain and checks every block itself. Node rewards begin 1 January 2029, under the rule that pays operators.

Full Setup Guide โ†’

๐Ÿ”Ž

Explorer API

Read the chain over plain HTTPS, with no key: chain status, blocks, accounts and transactions. For example https://explorer.promx.me/v1/chain

Open the explorer โ†’

๐Ÿ“ก

RPC Reference

JSON-RPC 2.0 over HTTPS at https://api.promx.me/rpc. Read methods need no key.

View RPC Docs (Coming soon)

The courier: its source code

The courier delivers each promise when it opens, and sends the acts the chain lists as due. It holds no authority: it sends only acts that any account may send, and it holds no one's key but its own. Its exact source is published under the MIT licence. Its build script reproduces the binary PromX runs, byte for byte (see its README).

Source: courier-source-p11-v2.tar.gz, sha256 4674661f49d178e7cc6b774d34b58c793f37e33b44cfbc9b0a4fac70c83c2a2f

Running courier: sha256 5d29cb660e5a889ed3edc1bd5393ec12aed24ecfe4dbe7ed9b202f37cdf29ae6

Download the source โ†’ ยท sha256 file

JSON-RPC 2.0

Talk to the Chain

The public endpoint is https://api.promx.me/rpc. Send standard JSON-RPC 2.0 requests. Read methods need no key.

# Chain facts: the chain id, heights and the rule set in force
curl -X POST https://api.promx.me/rpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"promx_chainInfo","params":[],"id":1}'