For the complete documentation index, see llms.txt. This page is also available as Markdown.

Publishing Conviction

Publishing Conviction Accounts let a publisher commit TRAC, register publishing agents, and use the account as the publish authority for curated Context Graph flows.

Use this page for the current CLI/API surface. For the economics model, see Conviction & Economics.

Create a PCA

dkg pca create --tokens 100000 --primary-node <identityId>

The daemon EOA becomes the owner of the PCA NFT. Owner-gated write operations must be run from the node whose EOA owns that NFT.

Register a Publishing Agent

dkg pca register-agent <accountId> <agentAddress>

The agent address must be a valid non-zero EVM address. Register the transaction-signing wallet address that will publish with the PCA. The daemon verifies registration with an on-chain read after the transaction lands when the adapter supports it.

The agent wallet still needs native gas, but it does not need an on-chain node identity. Node identity is only publisher-node attribution; PCA payment eligibility comes from PCA agent registration.

Deregister a Publishing Agent

dkg pca deregister-agent <accountId> <agentAddress>

This is owner-gated on-chain.

Add Funds

dkg pca funds <accountId> --tokens 50000

The CLI asks the daemon to approve token spend automatically before submitting the top-up transaction.

Settle

Settlement is permissionless. It runs the lazy-settlement sweep for the account.

Inspect

The read-only snapshot includes owner, committed TRAC, top-up buffer, base epoch allowance, creation and expiry epochs, agent count, settlement window, and discount basis points.

Use PCA With a Curated Context Graph

Attach a PCA to curated Context Graph registration with --pca-account-id:

pcaAccountId is valid only for curated publish policy. The daemon checks that the local curator matches the PCA owner before registering the Context Graph with the PCA.

API Routes

Route
Purpose

POST /api/pca

Create a PCA.

POST /api/pca/:id/agent

Register an agent.

DELETE /api/pca/:id/agent/:address

Deregister an agent.

POST /api/pca/:id/funds

Top up funds.

POST /api/pca/:id/settle

Run settlement.

GET /api/pca/:id

Read account info.

These routes require a configured chain adapter with V10 PCA support. Nodes without that surface return feature-unavailable responses instead of pretending the account does not exist.

Last updated

Was this helpful?