@edge-protocol/sdk 0.9.2 → 0.9.3

package/README.md

@@ -25,11 +25,13 @@ import { EdgePass, MIST_PER_SUI } from '@edge-protocol/sdk';
 
 const sdk = new EdgePass({ network: 'mainnet', enokiApiKey: 'YOUR_KEY' });
 const pass = await sdk.create(EdgePass.fromTemplate('festival', { owner: userAddress }), signer);
-const outcome = await sdk.execute(pass, { merchant: 'Hydra Bar', amount: 32n * MIST_PER_SUI }, signer);
+const outcome = await sdk.execute(pass, { merchant: 'Hydra Bar', amount: BigInt(32) * MIST_PER_SUI }, signer);
 
 console.log(outcome.status); // 'approved' | 'escalated' | 'blocked'
 ```
 
+> **Note:** BigInt literal syntax (`32n`) requires TypeScript targeting ES2020+. For ES2019 apps use `BigInt(32) * MIST_PER_SUI` instead.
+
 ---
 
 ## 🛠 The 5-Dimensional Trust Primitive
@@ -56,6 +58,7 @@ EdgePass.fromTemplate('gaming',       { owner })  // $50   · auto <$2   · esca
 EdgePass.fromTemplate('subscription', { owner })  // $200  · auto <$20  · escalate >$50  · 30d
 EdgePass.fromTemplate('defi',         { owner })  // $10k  · auto <$500 · escalate >$1k  · 7d
 EdgePass.fromTemplate('enterprise',   { owner })  // $50k  · auto <$1k  · escalate >$5k  · 30d
+EdgePass.fromTemplate('x402',         { owner })  // $1k   · auto <$10  · escalate >$100 · 24h · x402 payments
 ```
 
 Example — brand licensing agent:
@@ -63,7 +66,7 @@ Example — brand licensing agent:
 ```typescript
 EdgePass.fromTemplate('enterprise', {
   approvedMerchants: ['nike-licensing.sui', 'brand-registry.sui'],
-  escalateThreshold: 10_000n * MIST_PER_SUI,
+  escalateThreshold: BigInt(10_000) * MIST_PER_SUI,
   owner: cfoAddress,
 })
 // Enforce IP usage terms autonomously — no lawyers, no monitoring, no surprises
@@ -77,9 +80,9 @@ Plan an agent's session without touching the chain. Zero network calls.
 
 ```typescript
 const plan = sdk.simulate(pass, [
-  { merchant: 'Shuttle Express',  amount: 45n * MIST_PER_SUI },
-  { merchant: 'ShadyTokens.xyz',  amount: 1n },
-  { merchant: 'Stage Access VIP', amount: 220n * MIST_PER_SUI },
+  { merchant: 'Shuttle Express',  amount: BigInt(45) * MIST_PER_SUI },
+  { merchant: 'ShadyTokens.xyz',  amount: BigInt(1) },
+  { merchant: 'Stage Access VIP', amount: BigInt(220) * MIST_PER_SUI },
 ]);
 
 console.log(plan.summary);
@@ -159,7 +162,7 @@ const safePurchase = EdgePass.withPolicy(pass, signer, sdk, async (request) => {
 // blocked/escalated never reach your tool logic
 const { outcome, result } = await safePurchase({
   merchant: 'Hydra Bar',
-  amount: 32n * MIST_PER_SUI,
+  amount: BigInt(32) * MIST_PER_SUI,
 });
 ```
 
@@ -202,7 +205,7 @@ function AgentDashboard({ passId, signer }) {
   return (
     <div>
       <progress value={budgetStatus?.utilizationPct} max={100} />
-      <button onClick={() => execute({ merchant: 'Hydra Bar', amount: 32n * MIST_PER_SUI })}>
+      <button onClick={() => execute({ merchant: 'Hydra Bar', amount: BigInt(32) * MIST_PER_SUI })}>
         Purchase
       </button>
     </div>
@@ -291,6 +294,52 @@ if (preview.requiresEscalation) showEscalationModal(preview.reason);
 
 ---
 
+## 🔗 x402 Integration
+
+Edge and x402 are complementary layers in the autonomous payment stack.
+
+x402 answers: *how does money move from agent to merchant?*
+Edge answers: *should this agent be allowed to spend this money at all?*
+
+```
+Edge (policy layer)  →  x402 (payment rail)  →  Settlement
+"is this allowed?"       "move the money"
+```
+
+```typescript
+import { EdgePass, MIST_PER_SUI } from '@edge-protocol/sdk';
+
+// 1. Create a trust boundary scoped for x402 payments
+const pass = await sdk.create(
+  EdgePass.fromTemplate('x402', {
+    approvedMerchants: ['api.example.com', 'data.provider.com'],
+    owner: agentAddress,
+  }),
+  signer
+);
+
+// 2. Edge validates policy before x402 moves money
+const outcome = await sdk.execute(pass, {
+  merchant: endpoint,
+  amount: BigInt(Math.floor(amountUSD * 1e9)),
+}, signer);
+
+if (outcome.status === 'approved') {
+  // 3. x402 handles the actual payment
+  await fetch(endpoint, {
+    headers: { 'X-Payment': await createX402Payment(amount) }
+  });
+}
+
+if (outcome.status === 'escalated') {
+  await notifyUser('Payment requires your approval');
+}
+
+// blocked → never reaches x402, policy rejected it
+```
+
+---
+
 ## 🔒 Security Model
 
 Edge has two enforcement layers:
@@ -358,35 +407,29 @@ yarn add @edge-protocol/sdk
 ```
 
 React hook (requires React 18+):
-```bash
+```typescript
 import { useEdgePass } from '@edge-protocol/sdk/react';
 ```
 
+See [CHANGELOG.md](CHANGELOG.md) for version history.
+
 ---
 
 ## Competitive Positioning
 
 Edge is the **policy layer** for the agentic economy. It is not a payment rail.
 
-| Solution | Layer | Open Source | Sui Native | 3-line SDK |
-|----------|-------|-------------|------------|------------|
-| **Edge Protocol** | Policy enforcement | ✅ | ✅ | ✅ |
-| x402 (Coinbase) | Payment rail | ✅ | ❌ | ❌ |
-| ERC-4337 | Account abstraction | ✅ | ❌ EVM only | ❌ |
-| Trust Wallet Agent Kit | Wallet interactions | ✅ | Partial | ❌ |
-| Cobo Agentic Wallet | Custody | ❌ Enterprise | ❌ | ❌ |
-| Skyfire | Identity + settlement | ❌ | ❌ | ❌ |
+| Solution | Layer | Open Source | Sui Native | simulate() | 3-line SDK |
+|----------|-------|-------------|------------|------------|------------|
+| **Edge Protocol** | Policy enforcement | ✅ | ✅ | ✅ | ✅ |
+| x402 (Coinbase) | Payment rail | ✅ | ❌ | ❌ | ❌ |
+| ERC-4337 | Account abstraction | ✅ | ❌ EVM only | ❌ | ❌ |
+| Trust Wallet Agent Kit | Wallet interactions | ✅ | Partial | ❌ | ❌ |
+| Cobo Agentic Wallet | Custody | ❌ Enterprise | ❌ | ❌ | ❌ |
+| Skyfire | Identity + settlement | ❌ | ❌ | ❌ | ❌ |
 
 **Edge complements x402, it does not compete with it.**
 
-x402 answers: *how does money move from agent to merchant?*
-Edge answers: *should this agent be allowed to spend this money at all?*
-
-```
-Edge (policy layer)  →  x402 (payment rail)  →  Settlement
-"is this allowed?"       "move the money"
-```
-
 ---
 
 *The best infrastructure is invisible.*

package/dist/utils/constants.d.ts

@@ -43,6 +43,14 @@ export declare const EDGE_TEMPLATES: {
         readonly expiryMs: number;
         readonly approvedMerchants: string[];
     };
+    readonly x402: {
+        readonly budget: bigint;
+        readonly autoThreshold: bigint;
+        readonly escalateThreshold: bigint;
+        readonly maxPerTransaction: bigint;
+        readonly expiryMs: number;
+        readonly approvedMerchants: string[];
+    };
 };
 export type EdgePassTemplate = keyof typeof EDGE_TEMPLATES;
 export declare const FESTIVAL_MERCHANTS: string[];

package/dist/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,QAAwB,CAAC;AAElD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI/C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAqB,CAAC;AAIrD,eAAO,MAAM,cAAc;;;;;;;oCAOE,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;CAE3B,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAI3D,eAAO,MAAM,kBAAkB,UAM9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,QAAwB,CAAC;AAElD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI/C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIlD,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAqB,CAAC;AAIrD,eAAO,MAAM,cAAc;;;;;;;oCAOE,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAQR,MAAM,EAAE;;;;;;;;oCAWR,MAAM,EAAE;;CAE3B,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAI3D,eAAO,MAAM,kBAAkB,UAM9B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC"}

package/dist/utils/constants.js

@@ -55,6 +55,17 @@ exports.EDGE_TEMPLATES = {
         expiryMs: 30 * 24 * 60 * 60 * 1000,
         approvedMerchants: [],
     },
+    // x402 — designed for Coinbase x402 payment protocol integration
+    // Edge validates policy (should this agent pay?), x402 moves the money (how does it pay?)
+    // Together they form a complete autonomous payment stack.
+    x402: {
+        budget: BigInt(1000) * exports.MIST_PER_SUI,
+        autoThreshold: BigInt(10) * exports.MIST_PER_SUI,
+        escalateThreshold: BigInt(100) * exports.MIST_PER_SUI,
+        maxPerTransaction: BigInt(200) * exports.MIST_PER_SUI,
+        expiryMs: 24 * 60 * 60 * 1000,
+        approvedMerchants: [],
+    },
 };
 // ── Legacy festival constants (kept for backwards compat) ─────────────────
 exports.FESTIVAL_MERCHANTS = [

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edge-protocol/sdk",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Programmable trust infrastructure for autonomous AI agents on Sui. Give agents your rules, not your keys.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",