Polygon ID State Replication: API reference
This page contains technical resources related to the Polygon ID State Replication.
Demo DApp
Users can check out how the state replication works using our demo DApp. Leveraging the state replication lets users submit a Polygon ID zero-knowledge proof on Ethereum. Users get an SBT as a reward.
Testnet(Sepolia): https://polygon.mainnet-beta.rarimo.com/
Identity relayer
This service replicates GIST roots and identity states on demand. Call it before submitting proof on the destination chain.
- GitGub:
https://rarimo.github.io/identity-relayer-svc/
- API Reference:
https://rarimo.github.io/rarimo-core/docs/common/bridging/002-identity.html
- Testnet URI:
https://api.mainnet-beta.rarimo.com/integrations/relayer/
Relayer endpoints
To perform state publishing, you can execute POST /integrations/relayer/state/relay
request with the following body:
{
"chain": "Ethereum",
"hash": "0x212bc6f8194aa63eee97b0566b7cd65c66bb57cc4936c11e611f1042bb0b7118",
"waitConfirm": true
}
To perform GIST publishing, you can execute POST /integrations/relayer/gist/relay
request with the following body:
{
"chain": "Ethereum",
"hash": "0x1e4b74c14388fbfca27496828d24c248637792eb0286e7519860abb3ec01bc70",
"waitConfirm": true
}
"chain": "chain_name"
- chain, to which the state (or gist) will be relayed;"hash": "0x..."
- hash of the state (or gist) to relay. Same as on the state contract in 0x... hex format;"waitConfirm": true
indicates whether the request should wait until the transaction is included in the block (false
by default);
The response codes:
200
- successful relay, body contains tx hash;404
- the state is not transferred yet; try to repeat the request later;400
- state has been relayed before;