Skip to main content

​
What’s New

  • No contract required to start — test the API and integrate offchain before deploying contracts
  • Multi-chain support — deploy to multiple chains and manage them from a single project
  • Offchain policy management — update policies through the dashboard without onchain transactions
  • BasicPredicateClient — simpler integration for who-based policies (AML/KYC, allowlist/denylist) without calldata encoding

​
Changes

In V1, policyID on your contract selected which policy was enforced. Changing policies required an onchain setPolicy() transaction.In V2, the onchain policyID is set to a verification_hash value during dashboard setup. Policy selection and updates are managed entirely through the dashboard and enforced immediately. The onchain policyID remains unchanged.

​
Migration Checklist

1

Create project on dashboard

Create a new project on app.predicate.io and configure your policy. You’ll receive a verification_hash for your project.
2

Update offchain integration

Point API calls to /v2/attestation with verification_hash and chain (string). If using the SDK, import from @predicate/core/v2 and replace evaluatePolicy() with requestAttestation().
3

Deploy new contracts (if using onchain enforcement)

If you must upgrade existing contracts instead of deploying new ones, reach out to the Predicate team to coordinate.
Implement BasicPredicateClient or PredicateClient with the Predicate Registry address. Set your verification_hash as the policyID.
4

Add contracts to dashboard

Register your contract addresses in the dashboard to link them to your project.
5

Update API calls for onchain

Replace verification_hash with to (your contract address) in API requests. Pass the Attestation struct to your contract functions.