newton-cli and the SDK; the dashboard packages the same operations into a guided flow.
Sign in
Go to dashboard.newton.xyz and sign in. You’ll need an email (for the one-time sign-in code) and a wallet (to sign the on-chain transactions for registering and deploying).Generate an API key
Open API Keys in the left navigation. Your key is generated and ready to use — copy it for SDK or CLI integration. API keys authenticate calls to the Newton Gateway and authorize secrets management. See Dashboard & API Keys for permissions, rotation, and programmatic key management.Create a project
Creating a project walks through naming it, choosing a chain (Sepolia or Base Sepolia), setting a PolicyClient, and selecting data oracles. Pick oracles from the built-in policy packs (Chainalysis, vaults.fyi, Webacy, RedStone) or add a custom one by its deployed PolicyData address. Selecting a built-in oracle pre-fills a Rego template, default parameters, and the list of secrets it requires, so you start from a working baseline.A PolicyClient is required to get into the editor. Either enter the address of an existing one (a contract that inherits
NewtonPolicyClient — see Smart Contract Integration), or click Deploy a sample one to have the dashboard deploy a template NewtonPolicyWallet for you.Edit the policy
The policy editor is a three-pane workspace:- Rego editor — a Monaco editor with syntax highlighting for your
policy.rego. Edit the rules directly. - Oracle sidebar — add or remove data oracles. Adding more than one produces a multi-oracle policy; each oracle’s output is namespaced under its pack id, so reference it in Rego as
data.wasm.<pack-id>.*. - Configuration — per oracle, set:
- Parameters — the thresholds your Rego reads from
data.params.<pack-id>.*(e.g.risk_score_floor). - Secrets — the API key(s) the oracle needs (e.g.
VAULTS_FYI_API_KEY). The dashboard encrypts these client-side and uploads them per PolicyData address, exactly likenewton-cli secrets upload.
- Parameters — the thresholds your Rego reads from
Simulate
Before deploying, run a simulation from the editor. Provide:- WASM args — the per-call inputs each oracle expects (e.g.
{ "network": "mainnet", "vaultAddress": "0x..." }). - Intent — the transaction being evaluated (
from,to,value,data,chain_id). - Params — your namespaced parameters.
data.wasm, and evaluates your Rego — then shows the allow/deny result and the merged data the policy saw. Use this to confirm your Rego references resolve and the decision is what you expect. This is the same evaluation newt_simulatePolicy performs; see Testing Policies & Oracles.
Deploy
When the policy behaves correctly, deploy it. The dashboard:- Generates CIDs for your Rego and schemas and uploads them to IPFS.
- Deploys the PolicyData contract(s) and the
NewtonPolicycontract — bound to all selected oracle addresses, so multi-oracle policies deploy in one step. - Binds the policy to your PolicyClient and records the deployed addresses.
policy deploy.
Integrate with Newton Shield
For projects using the Newton Shield template, the dashboard generates a ready-to-paste integration snippet — theNewtonShield setup with your API key, PolicyClient address, and chain — plus the deployed contract addresses and links to inspect transactions. Copy it into your application to start submitting intents. For custom integrations, wire the deployed policy address into your smart contract per Smart Contract Integration.
Next Steps
Dashboard & API Keys
Permissions, rotation, and programmatic key management
Policy Packs
The oracles available in the editor
Chaining Data Oracles
How multiple oracles compose under one policy
CLI Reference
The same operations from the command line