DEVELOPER RESOURCES
Build with clarity.
Everything you need to run the preview — and understand what is not live.
01 / START LOCALLY
Your workspace, in one command.
Extract the full source ZIP. Open the folder containing package.json. Use Node.js 22.16 or newer, then run:
npm startOpen http://127.0.0.1:8787. The homepage, app and local API run together. No dependency install is needed for the local application. The optional on-chain package is separate.
On Windows, START-LOCAL.cmd starts the same server. On macOS/Linux, use sh start-local.sh. Run npm run verify for the local automated tests.
02 / WHAT YOU CAN TRY
Two workspaces. One foundation.
V1 — Gas station
Select a configured chain and fee token, quote one or more fixed test transfers, authorize the exact operation and inspect the simulated settlement. Unused prefunding becomes reusable local credit. It is not a wallet refund.
V2 — Route laboratory
Compare fictional providers for an equivalent destination outcome. Quotes disclose source gas, approval gas, bridge fee, destination gas, service fee and slippage reserve. Run a local lifecycle and inspect stored events.
Neither workspace broadcasts transactions. The app is not an arbitrary swap router and does not move tokens.
Open the app →03 / NETWORK SCOPE
Configuration is not deployment.
| Network family | Local configuration | Live execution |
|---|---|---|
| Ethereum | Mainnet + Sepolia simulation | Not enabled |
| Base | Mainnet + Sepolia simulation | Not enabled |
| Arbitrum | One + Sepolia simulation | Not enabled |
| BNB Chain | Planned, not integrated | Not supported |
USDC, USDT and DEXIVO labels in this preview use fictional chain-specific addresses and prices. The existing DEXIVO token is not redeployed or changed. Acceptance on a real chain requires verified deployment or bridging and an approved pricing source.
Network names indicate intended compatibility, not partnerships or endorsements.
04 / LOCAL API
Inspect. Integrate. Iterate.
Create a scoped key in the Developer Console. Store the secret outside browser code. The API runs on the same local server and is not configured for public hosting.
import { DexivoClient } from './src/sdk.mjs';
const client = new DexivoClient({
baseUrl: 'http://127.0.0.1:8787',
apiKey: process.env.DEXIVO_API_KEY
});
console.log(await client.dashboard());| Endpoint | Purpose |
|---|---|
GET /v1/chains | Configured simulation chains |
POST /v1/quote | Quote fixed test transfers |
POST /v1/paymaster/authorize | Bind the exact local operation |
POST /v1/simulations/execute | Record a simulated settlement |
POST /v2/routes/quote | Compare fictional routes |
GET /v2/dashboard | Project budgets and records |
Requests require a local session or scoped API key. Mutating requests use an Idempotency-Key header. Full schemas and examples are in docs/API.md inside the source package.
05 / WALLET BOUNDARY
Your keys stay with you.
The preview works without a wallet. Optional connection reads a public owner address from an injected wallet. It does not request a transaction signature, token approval, seed phrase or private key. The displayed smart account remains a synthetic simulation account.
Mobile layout is supported. Mobile WalletConnect and real smart-account onboarding are not integrated.
06 / BEFORE REAL FUNDS
Evidence before activation.
The optional Solidity package is a candidate, not an audited or verified deployment. It still needs compilation, contract tests, real bundler and smart-account integration, verified pricing, public-testnet execution, bridge-specific recovery, production operations and independent security review.
The development server accepts loopback hosts only. Do not remove that protection or expose local administration to the internet. The separate static website bundle can be hosted as a clearly labelled public preview; it does not contain the local financial API.
Open release status ↗