@usesigil/kit 0.8.0 → 0.10.0

package/README.md

@@ -1,8 +1,10 @@
 # @usesigil/kit
 
-Kit-native TypeScript SDK for Sigil — on-chain spending limits and permission policies for AI agent wallets on Solana.
+Kit-native TypeScript SDK for **Sigil** — on-chain spending limits, permission policies, and audit trails for AI-agent wallets on Solana.
 
-Sigil wraps arbitrary DeFi instructions with security guardrails. Your agents trade through Jupiter, Flash Trade, Drift, or any Solana protocol while vault policies enforce spending caps, permission bitmasks, and protocol allowlists.
+> **Sigil is a security wrapper, not a DeFi SDK.** Your agents keep using Jupiter, Flash Trade, Drift, or any Solana protocol. Sigil wraps the instructions they produce with a validate-and-authorize gate, enforces the policies the vault owner configured, and records the outcome — all without touching the underlying DeFi logic.
+
+---
 
 ## Install
 
@@ -12,203 +14,214 @@ npm install @usesigil/kit @solana/kit
 
 `@solana/kit ^6.2.0` is a peer dependency. Node >= 18.
 
+---
+
+## Mental model
+
+Sigil separates **authority** (owner) from **execution** (agents), enforced at the Solana transaction boundary rather than only in application code.
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                       OWNER (human or DAO)                       │
+│   - Creates vault, sets policy (caps / timelock / allowlist)     │
+│   - Registers agent signing keys                                 │
+│   - Withdraws funds, freezes vault, revokes agents               │
+│   - Cannot be impersonated by any agent                          │
+└──────────────────────────┬───────────────────────────────────────┘
+                           │ owner-signed transactions
+                           ▼
+┌──────────────────────────────────────────────────────────────────┐
+│                    SIGIL ON-CHAIN PROGRAM                        │
+│   ┌──────────────┐  ┌──────────────┐  ┌─────────────────────┐    │
+│   │ AgentVault   │  │ PolicyConfig │  │ SpendTracker        │    │
+│   │  (funds)     │  │  (limits)    │  │  (rolling 24 h)     │    │
+│   └──────────────┘  └──────────────┘  └─────────────────────┘    │
+│                                                                  │
+│   Every spending tx is `[validate, <DeFi ix>, finalize]`.        │
+│   The sandwich cannot be decomposed — all succeed or all revert. │
+└──────────────────────────┬───────────────────────────────────────┘
+                           │ validated tx
+                           ▼
+┌──────────────────────────────────────────────────────────────────┐
+│        DeFi protocols (Jupiter, Flash Trade, Drift, …)           │
+│        Sigil does not touch this layer — no protocol SDK needed. │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+Nothing an agent does can bypass the on-chain gate. If the validate instruction rejects — cap exceeded, protocol not allowed, agent paused — the entire transaction reverts before any funds move.
+
+---
+
 ## Quickstart
 
-```typescript
+Provision a vault and execute your first agent-authorized swap:
+
+```ts
 import {
-  SigilClient,
   createAndSendVault,
-  ActionType,
-  toAgentError,
-  formatUsd,
-  USDC_MINT_DEVNET,
+  SigilClient,
+  SAFETY_PRESETS,
+  parseUsd,
+  createConsoleLogger,
 } from "@usesigil/kit";
-import { address, createSolanaRpc } from "@solana/kit";
 
-// 1. Create a vault (owner operation — run once)
-const rpc = createSolanaRpc("https://api.devnet.solana.com");
-const vault = await createAndSendVault({
-  rpc,
+// 1. Owner provisions the vault on devnet.
+const { vaultAddress } = await createAndSendVault({
+  rpc,                     // Rpc<SolanaRpcApi> from @solana/kit
   network: "devnet",
-  owner,              // TransactionSigner (vault authority)
-  agent,              // TransactionSigner (AI agent key)
-  dailySpendingCapUsd: 500_000_000n,  // $500 in USDC base units
+  owner: ownerSigner,      // TransactionSigner
+  agent: agentSigner,      // TransactionSigner — separate key from owner
+  // Required safety posture (v0.9.0 — no silent defaults):
+  ...SAFETY_PRESETS.development,
 });
-console.log(`Vault created: ${vault.vaultAddress}`);
 
-// 2. Wrap a Jupiter swap (agent operation — per trade)
-const client = new SigilClient({
+// 2. Agent opens an async client with genesis-hash verification.
+const client = await SigilClient.create({
   rpc,
-  vault: vault.vaultAddress,
-  agent,
+  vault: vaultAddress,
+  agent: agentSigner,
   network: "devnet",
+  logger: createConsoleLogger(), // opt in to structured warnings
 });
 
-const jupiterInstructions = /* from Jupiter /swap-instructions API */;
+// 3. Wrap arbitrary DeFi instructions from Jupiter, SAK, MCP, etc.
+const jupiterInstructions = await buildJupiterSwap(/* your call */);
 const { signature } = await client.executeAndConfirm(jupiterInstructions, {
   tokenMint: USDC_MINT_DEVNET,
-  amount: 100_000_000n,           // $100 USDC
-  actionType: ActionType.Swap,
-  protocolAltAddresses: jupiterResponse.addressLookupTableAddresses,
+  amount: parseUsd("$10"), // strict parser → 10_000_000n base units
 });
-
-// 3. Check P&L
-const pnl = await client.getPnL();
-console.log(`P&L: ${formatUsd(pnl.pnl)}`);
 ```
 
-See [`examples/jupiter-swap.ts`](./examples/jupiter-swap.ts) for a complete, runnable example with Jupiter API calls, instruction parsing, ALT extraction, and error handling.
-
-## Architecture
+The agent's signing key is never enough on its own — Sigil's validate instruction in the same transaction has to authorize the spend, and the finalize instruction has to record it. A leaked agent key cannot exceed the owner-configured daily cap or transfer to a non-allowed destination.
 
-```
-Transaction = [validate_and_authorize, ...defiInstructions, finalize_session]
-```
+---
 
-Sigil wraps arbitrary DeFi instructions from any source (Jupiter API, Solana Agent Kit, MCP servers) and sandwiches them with on-chain security checks. All instructions succeed or all revert atomically. The SDK handles instruction composition, ATA rewriting, ALT compression, and pre-flight validation.
+## Security boundary
 
-## API Overview
+**What the on-chain program enforces:**
+- Daily and per-transaction spending caps (`dailySpendingCapUsd`, `maxTransactionSizeUsd`)
+- Per-agent spending limits (`spendingLimitUsd`)
+- Protocol allowlist / denylist (`protocols`, `protocolMode`)
+- Slippage tolerance on Jupiter swaps (`maxSlippageBps`)
+- Session expiry, position counters, leverage limits
+- Owner timelock on policy changes (`timelockDuration`)
 
-### Core — Create vaults, wrap instructions, execute
+**What the SDK enforces pre-submission:**
+- Agent capability check (2-bit enum: Disabled / Observer / Operator)
+- Genesis-hash assertion on `SigilClient.create()` — prevents cluster mismatch
+- Strict USD parsing (`parseUsd`) — no `parseFloat` rounding
+- Aggregate cap guard — sum of per-agent caps ≤ vault cap
+- SPL token-operation detection — blocks non-whitelisted transfer patterns
 
-| Export | Description |
-|--------|-------------|
-| `SigilClient` | Stateful client — holds vault/agent/network, manages caches. Recommended for production. |
-| `wrap()` | Stateless wrapping function — takes DeFi instructions, returns a composed transaction. |
-| `createVault()` | Build vault creation instructions (caller signs and sends). |
-| `createAndSendVault()` | One-call vault creation — build, sign, send, confirm. |
-| `buildOwnerTransaction()` | Compose owner-only transactions (policy updates, agent management). |
-| `withVault()` | Policy-guided vault creation — policies in, wrapped client out. |
+**What the SDK does NOT attempt:**
+- Key custody — bring your own `TransactionSigner` (Turnkey, Crossmint, Privy, or a local keypair)
+- Transaction simulation outcome trust — simulation is a hint, not a guarantee; on-chain enforcement is the source of truth
+- Replay prevention outside a session — agents must start a new session per transaction
 
-### State — Query vaults, budgets, spending
+If a piece of SDK logic is wrong, the worst a consumer loses is some UX clarity — the on-chain program still rejects the bad transaction. The boundary is deliberate.
 
-| Export | Description |
-|--------|-------------|
-| `resolveVaultState()` | Fetch complete vault state (accounts, policy, tracker, overlay, constraints). |
-| `resolveVaultBudget()` | Per-agent budget: rolling 24h spend, cap, remaining headroom. |
-| `getSpendingHistory()` | 144-epoch circular buffer to chart-ready time series. |
-| `findVaultsByOwner()` | Enumerate all vaults owned by an address. |
-| `resolveVaultStateForOwner()` | Vault state with pending policy/constraint updates for dashboards. |
+---
 
-### Analytics — Security checks, agent metrics, portfolio
+## Configuration presets
 
-| Export | Description |
-|--------|-------------|
-| `getSecurityPosture()` | 13-point security assessment with pass/fail, severity, remediation. |
-| `getVaultHealth()` | Risk score, liquidity, utilization. |
-| `getAgentProfile()` | Single agent stats — spend, tx count, errors. |
-| `getAgentLeaderboard()` | Top agents by spend or profit. |
-| `getPortfolioOverview()` | Cross-vault summary for multi-vault operators. |
-| `getAuditTrail()` | Chronological audit log filtered by category, actor, or time range. |
-| `getSpendingVelocity()` | Rate of spend over configurable time windows. |
+### Use-case presets (`VAULT_PRESETS`)
 
-7 analytics modules with 42 functions total — see source for the full list.
+Starting templates for specific agent roles. Each sets capability, allowlist, slippage, and caps appropriate for the use case:
 
-### Safety — Pre-flight checks, error handling
+- `jupiter-swap-bot` — Jupiter only, conservative caps ($500/day, $100/tx)
+- `perps-trader` — Jupiter + Flash Trade, 10× leverage, $5,000/day
+- `lending-optimizer` — Jupiter Lend + Kamino, 1% slippage, $2,000/day
+- `full-access` — every protocol allowed, $10,000/day, 20× leverage
 
-| Export | Description |
-|--------|-------------|
-| `shield()` | Client-side policy gate — evaluate instructions before signing. |
-| `simulateBeforeSend()` | RPC simulation with error extraction. |
-| `detectDrainAttempt()` | Heuristic drain detection from balance deltas. |
-| `toAgentError()` | Convert any error to structured `AgentError` with category, retryable flag, and recovery actions. |
+### Safety presets (`SAFETY_PRESETS`) — v0.9.0
 
-### Formatting — Display helpers (11 functions)
+Orthogonal to the use-case presets. Picks safe defaults for timelock and caps without prescribing a use case:
 
-| Export | Description |
-|--------|-------------|
-| `formatUsd()` | `$1,234.56` with full precision |
-| `formatUsdCompact()` | `$1.2M`, `$500K` |
-| `formatPercent()` | `12.34%` |
-| `formatDuration()` | `1d 2h 3m` |
-| `formatAddress()` | `4ZeV...wrHL` |
-| `formatTokenAmount()` | `1,000.000000 USDC` |
+- `development` — 30-min timelock, $100/agent, $500/day. Safe for devnet / CI.
+- `production` — 24-hour timelock, caps explicitly `null`. You must supply real values via `applySafetyPreset("production", { ... })` — the SDK will throw if you try to use an unfilled production preset with `createVault`.
 
-Plus: `formatUsdSigned`, `formatPercentSigned`, `formatRelativeTime`, `formatTimeUntil`, `formatTokenAmountCompact`.
+Compose them:
 
-### Presets — Vault templates
+```ts
+import { createVault, VAULT_PRESETS, applySafetyPreset } from "@usesigil/kit";
 
-4 pre-configured vault templates for common use cases:
+const presetFields = VAULT_PRESETS["jupiter-swap-bot"];
+const safety = applySafetyPreset("production", {
+  spendingLimitUsd: 1_000_000_000n,        // $1,000 per agent
+  dailySpendingCapUsd: 10_000_000_000n,    // $10,000 vault-wide
+});
+await createVault({
+  rpc, network: "mainnet", owner, agent,
+  ...presetFields,
+  ...safety,
+});
+```
 
-| Preset | Permissions | Daily Cap | Slippage |
-|--------|------------|-----------|----------|
-| `jupiter-swap-bot` | Swap only | $500 | 2% |
-| `perps-trader` | Perps + Swap | $5,000 | 5% |
-| `lending-optimizer` | Deposit/Withdraw | $2,000 | 1% |
-| `full-access` | All 21 actions | $10,000 | 5% |
+---
 
-```typescript
-import { getPreset, presetToCreateVaultFields } from "@usesigil/kit";
+## Jupiter integration
 
-const preset = getPreset("jupiter-swap-bot");
-const fields = presetToCreateVaultFields(preset);
-```
+`@usesigil/kit` does not wrap Jupiter. Use the official [`@jup-ag/api`](https://www.npmjs.com/package/@jup-ag/api) client to build swap instructions, then pipe the `Instruction[]` through `seal()`:
 
-### HTTP 402 Payments (x402)
+```ts
+import { createJupiterApiClient } from "@jup-ag/api";
+import { seal } from "@usesigil/kit";
 
-Sigil supports the [x402 standard](https://www.x402.org/) for automatic HTTP 402 payment negotiation on Solana. Use `shieldedFetch()` to handle payment-required responses transparently — spending limits and vault policies are enforced on every payment.
+const jupiter = createJupiterApiClient();
+const { swapTransaction, addressLookupTableAddresses } = await jupiter.swapPost(
+  { quoteResponse, userPublicKey: vault },
+);
 
-```typescript
-import { shieldedFetch, createShieldedFetch } from "@usesigil/kit/x402";
+// Extract instructions from the serialized swapTransaction (helper omitted
+// for brevity — decode with @solana/kit's `getCompiledTransactionMessageDecoder`
+// then convert each CompiledInstruction to the Kit Instruction shape).
+const jupiterIxs: Instruction[] = decodeSwapInstructions(swapTransaction);
 
-// One-shot: fetch a paywalled URL, auto-negotiate payment
-const response = await shieldedFetch(url, {
-  vault, agent, rpc, network: "devnet",
-  maxPaymentUsd: 1_000_000n, // $1 max per request
+const sealed = await seal({
+  rpc, network: "devnet",
+  vault, agent: agentSigner,
+  instructions: jupiterIxs,
+  tokenMint: USDC_MINT_DEVNET,
+  amount: 10_000_000n,                               // $10 in base units
+  protocolAltAddresses: addressLookupTableAddresses, // rotate per-route
 });
-
-if (response.x402?.paid) {
-  console.log(`Paid ${response.x402.amount} to ${response.x402.payTo}`);
-}
-
-// Reusable: create a pre-configured fetch function
-const fetch402 = createShieldedFetch({ vault, agent, rpc, network: "devnet" });
-const res = await fetch402("https://api.example.com/premium-data");
 ```
 
-The x402 subpath exports codec functions (header parsing), payment selectors, nonce tracking, amount validation, and 5 typed error classes (`X402ParseError`, `X402PaymentError`, `X402UnsupportedError`, `X402DestinationBlockedError`, `X402ReplayError`). See [INSTRUCTIONS.md](../docs/INSTRUCTIONS.md) for the full 12-step `shieldedFetch()` flow.
-
-## Error Handling
+Any Jupiter-supported protocol flows through the same path; Sigil treats the instructions opaquely and enforces policy on the account touches Jupiter actually makes.
 
-All errors from `wrap()` and `executeAndConfirm()` convert to structured `AgentError`:
+---
 
-```typescript
-import { toAgentError } from "@usesigil/kit";
-
-try {
-  await client.executeAndConfirm(instructions, opts);
-} catch (err) {
-  const e = toAgentError(err);
-  console.log(e.category);          // "PERMISSION" | "SPENDING_CAP" | "INPUT_VALIDATION" | ...
-  console.log(e.retryable);         // boolean
-  console.log(e.recovery_actions);  // [{ action, description, tool? }]
-}
-```
+## Subpath imports
 
-10 error categories with recovery guidance. 71 on-chain error codes (6000-6070) mapped.
+| Import | Use for |
+|--------|---------|
+| `@usesigil/kit` | Main API: `seal`, `SigilClient`, `createVault`, analytics, presets |
+| `@usesigil/kit/errors` | The 49 `SIGIL_ERROR__*` code constants for `catch`-block narrowing |
+| `@usesigil/kit/dashboard` | `OwnerClient` for vault management (reads + owner mutations) |
+| `@usesigil/kit/x402` | HTTP 402 Payment Required helpers (`shieldedFetch`, payment parsing) |
+| `@usesigil/kit/testing` | Mock RPCs and fixtures for unit tests |
+| `@usesigil/kit/testing/devnet` | Devnet test harness (browser-incompatible — Node only) |
 
-## Testing
-
-```typescript
-// Browser-safe mocks (no node:fs, no @solana/web3.js)
-import { createMockRpc, createMockVaultState } from "@usesigil/kit/testing";
-
-// Real devnet helpers (Node-only)
-import { provisionVault, createDevnetRpc } from "@usesigil/kit/testing/devnet";
-```
+---
 
-`@usesigil/kit/testing` provides mock factories for unit tests. `@usesigil/kit/testing/devnet` provides real devnet helpers (vault provisioning, funded agents, USDC airdrops). The devnet subpath imports `node:fs` and `@solana/web3.js` — keep it out of browser bundles.
+## v0.8 → v0.9 migration
 
-## Examples
+v0.9.0 is a breaking release. The headline changes:
 
-- [`examples/jupiter-swap.ts`](./examples/jupiter-swap.ts) — Complete Jupiter V6 swap via Sigil with error handling and P&L tracking
+1. **`createVault` now requires three fields** that previously had silent defaults: `spendingLimitUsd`, `dailySpendingCapUsd`, `timelockDuration`. Set them explicitly or spread `SAFETY_PRESETS.development` / `applySafetyPreset("production", {...})`.
+2. **`SigilClient.create(config)` is the new preferred entry point** — it asserts the RPC's genesis hash matches the configured network. `new SigilClient(config)` is deprecated (removal in Sprint 2) and logs a warning.
+3. **49 `SIGIL_ERROR__*` constants moved from the root barrel** to the `./errors` subpath. Update imports:
+   ```diff
+   - import { SIGIL_ERROR__SDK__CAP_EXCEEDED } from "@usesigil/kit";
+   + import { SIGIL_ERROR__SDK__CAP_EXCEEDED } from "@usesigil/kit/errors";
+   ```
+4. **Root barrel lost ~325 exports** (Codama instruction builders, event/struct types, hex error constants). Consumers who imported generated internals should migrate to `seal()` / `createVault()` / `OwnerClient`. Account decoders stay at root.
+5. **Structured logger replaces `console.warn`** inside the SDK. Pass `logger: createConsoleLogger()` to `SigilClient.create()` (or your preferred logger matching the `SigilLogger` interface) to receive diagnostic output.
 
-## Links
+See `CHANGELOG.md` and the upgrade checklist for every grep you need to run.
 
-- [GitHub](https://github.com/Sigil-Trade/sigil)
-- [npm](https://www.npmjs.com/package/@usesigil/kit)
-- [Issues](https://github.com/Sigil-Trade/sigil/issues)
+---
 
 ## License
 
-Apache-2.0
+Apache-2.0. Copyright 2024-2026 Kaleb Rupe.

package/dist/alt-config.d.ts

@@ -29,10 +29,12 @@ export declare const EXPECTED_ALT_CONTENTS_DEVNET: Address[];
 /**
  * Expected contents of the mainnet Sigil ALT.
  * Uses mainnet mints; treasury is the same across networks.
- * TODO: Add TREASURY_USDC_ATA_MAINNET and TREASURY_USDT_ATA_MAINNET
- * after deploying and extending the mainnet ALT. Derive from:
+ *
+ * Pre-mainnet task: extend this array with TREASURY_USDC_ATA_MAINNET and
+ * TREASURY_USDT_ATA_MAINNET after deploying the mainnet ALT. Derive via:
  *   getAssociatedTokenAddress(USDC_MINT_MAINNET, PROTOCOL_TREASURY, true)
  *   getAssociatedTokenAddress(USDT_MINT_MAINNET, PROTOCOL_TREASURY, true)
+ * Tracked alongside mainnet deployment checklist (D3 — upgrade authority transfer).
  */
 export declare const EXPECTED_ALT_CONTENTS_MAINNET: Address[];
 /**

package/dist/alt-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alt-config.d.ts","sourceRoot":"","sources":["../src/alt-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAW1C,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,EACuB,OAAO,CAAC;AAE5D,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,EAAyC,OAAO,CAAC;AAU/E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ5D;AAYD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAAO,EAQjD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAAO,EAMlD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAIlE"}
+{"version":3,"file":"alt-config.d.ts","sourceRoot":"","sources":["../src/alt-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAW1C,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,EACuB,OAAO,CAAC;AAE5D,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,EAAyC,OAAO,CAAC;AAU/E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ5D;AAYD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAAO,EAQjD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,EAAE,OAAO,EAMlD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAIlE"}

package/dist/alt-config.js

@@ -54,10 +54,12 @@ export const EXPECTED_ALT_CONTENTS_DEVNET = [
 /**
  * Expected contents of the mainnet Sigil ALT.
  * Uses mainnet mints; treasury is the same across networks.
- * TODO: Add TREASURY_USDC_ATA_MAINNET and TREASURY_USDT_ATA_MAINNET
- * after deploying and extending the mainnet ALT. Derive from:
+ *
+ * Pre-mainnet task: extend this array with TREASURY_USDC_ATA_MAINNET and
+ * TREASURY_USDT_ATA_MAINNET after deploying the mainnet ALT. Derive via:
  *   getAssociatedTokenAddress(USDC_MINT_MAINNET, PROTOCOL_TREASURY, true)
  *   getAssociatedTokenAddress(USDT_MINT_MAINNET, PROTOCOL_TREASURY, true)
+ * Tracked alongside mainnet deployment checklist (D3 — upgrade authority transfer).
  */
 export const EXPECTED_ALT_CONTENTS_MAINNET = [
     USDC_MINT_MAINNET,

package/dist/alt-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"alt-config.js","sourceRoot":"","sources":["../src/alt-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAE/E,sGAAsG;AACtG,MAAM,CAAC,MAAM,gBAAgB,GAC3B,8CAAyD,CAAC;AAE5D,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAA6C,CAAC;AAE/E,0DAA0D;AAC1D,MAAM,mBAAmB,GACvB,6CAAwD,CAAC;AAC3D,MAAM,YAAY,GAAG,6CAAwD,CAAC;AAE9E,iFAAiF;AACjF,MAAM,eAAe,GAAG,kCAA6C,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAC;IAClD,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAEhF,qFAAqF;AACrF,MAAM,wBAAwB,GAC5B,8CAAyD,CAAC;AAE5D,qFAAqF;AACrF,MAAM,wBAAwB,GAC5B,8CAAyD,CAAC;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAc;IACrD,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,YAAY;IACZ,wBAAwB;IACxB,wBAAwB;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAc;IACtD,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,YAAY;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,6BAA6B,CAAC;AACpC,CAAC"}
+{"version":3,"file":"alt-config.js","sourceRoot":"","sources":["../src/alt-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAE/E,sGAAsG;AACtG,MAAM,CAAC,MAAM,gBAAgB,GAC3B,8CAAyD,CAAC;AAE5D,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,kCAA6C,CAAC;AAE/E,0DAA0D;AAC1D,MAAM,mBAAmB,GACvB,6CAAwD,CAAC;AAC3D,MAAM,YAAY,GAAG,6CAAwD,CAAC;AAE9E,iFAAiF;AACjF,MAAM,eAAe,GAAG,kCAA6C,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAC;IAClD,IAAI,iBAAiB,KAAK,eAAe,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAEhF,qFAAqF;AACrF,MAAM,wBAAwB,GAC5B,8CAAyD,CAAC;AAE5D,qFAAqF;AACrF,MAAM,wBAAwB,GAC5B,8CAAyD,CAAC;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAc;IACrD,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,YAAY;IACZ,wBAAwB;IACxB,wBAAwB;CACzB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAc;IACtD,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,YAAY;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,6BAA6B,CAAC;AACpC,CAAC"}

package/dist/alt-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alt-loader.d.ts","sourceRoot":"","sources":["../src/alt-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,kBAAkB,CAAC;AAa1B,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAK5C;;;;;OAKG;IACG,OAAO,CACX,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,YAAY,EAAE,OAAO,EAAE,GACtB,OAAO,CAAC,6BAA6B,CAAC;IAyDzC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS;IAM9D,gCAAgC;IAChC,UAAU,IAAI,IAAI;CAGnB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EACjB,YAAY,CAAC,EAAE,OAAO,EAAE,GACvB,OAAO,EAAE,CAoBX;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,6BAA6B,EACvC,eAAe,EAAE,OAAO,EACxB,gBAAgB,EAAE,OAAO,EAAE,GAC1B,IAAI,CAyBN"}
+{"version":3,"file":"alt-loader.d.ts","sourceRoot":"","sources":["../src/alt-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,kBAAkB,CAAC;AAc1B,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAK5C;;;;;OAKG;IACG,OAAO,CACX,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,YAAY,EAAE,OAAO,EAAE,GACtB,OAAO,CAAC,6BAA6B,CAAC;IAyDzC;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS;IAM9D,gCAAgC;IAChC,UAAU,IAAI,IAAI;CAGnB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EACjB,YAAY,CAAC,EAAE,OAAO,EAAE,GACvB,OAAO,EAAE,CAoBX;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,6BAA6B,EACvC,eAAe,EAAE,OAAO,EACxB,gBAAgB,EAAE,OAAO,EAAE,GAC1B,IAAI,CAyBN"}

package/dist/alt-loader.js

@@ -8,6 +8,7 @@
  * - Deduplication when merging Sigil + protocol ALTs
  */
 import { fetchAddressesForLookupTables, } from "./kit-adapter.js";
+import { getSigilModuleLogger } from "./logger.js";
 import { SigilSdkDomainError } from "./errors/sdk.js";
 import { SIGIL_ERROR__SDK__ALT_INTEGRITY } from "./errors/codes.js";
 // ─── AltCache ─────────────────────────────────────────────────────────────────
@@ -69,7 +70,7 @@ export class AltCache {
             catch (e) {
                 // S-4: Graceful degradation — return whatever we have from cache
                 // The composer works without ALTs; transactions just may be larger
-                console.warn("[AltCache] ALT fetch failed, proceeding without:", e instanceof Error ? e.message : e);
+                getSigilModuleLogger().warn("[AltCache] ALT fetch failed, proceeding without", { error: e instanceof Error ? e.message : String(e) });
             }
         }
         return result;

package/dist/alt-loader.js.map

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

package/dist/balance-tracker.d.ts

@@ -96,6 +96,13 @@ export declare class BalanceSnapshotStore {
     get size(): number;
     clear(): void;
     toJSON(): string;
+    /**
+     * Reconstruct a BalanceSnapshotStore from its JSON serialization.
+     *
+     * F12 fix (type-design-analyzer): wraps BigInt() calls in try/catch so
+     * corrupted JSON surfaces a domain-relevant error instead of raw
+     * SyntaxError from BigInt("not-a-number").
+     */
     static fromJSON(json: string): BalanceSnapshotStore;
 }
 /**

package/dist/balance-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"balance-tracker.d.ts","sourceRoot":"","sources":["../src/balance-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAO5D,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,KAAK,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,kBAAkB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,GAAG,QAAQ,CAiBX;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAgBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAID;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,UAAU,SAAM;IAI5B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAkB3D,WAAW,IAAI,eAAe,GAAG,IAAI;IAIrC,QAAQ,IAAI,eAAe,GAAG,IAAI;IAMlC,SAAS,IAAI,eAAe,GAAG,IAAI;IAMnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,MAAM;IAmBhB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB;CA0BpD;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,OAAwB,GAChC,UAAU,CAwBZ"}
+{"version":3,"file":"balance-tracker.d.ts","sourceRoot":"","sources":["../src/balance-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ5D,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,KAAK,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,kBAAkB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,GAAG,QAAQ,CAiBX;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAgBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,OAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAID;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,UAAU,SAAM;IAI5B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAkB3D,WAAW,IAAI,eAAe,GAAG,IAAI;IAIrC,QAAQ,IAAI,eAAe,GAAG,IAAI;IAMlC,SAAS,IAAI,eAAe,GAAG,IAAI;IAMnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,MAAM;IAmBhB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB;CAsCpD;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,OAAwB,GAChC,UAAU,CAwBZ"}

package/dist/balance-tracker.js

@@ -6,9 +6,10 @@
  * - `BalanceSnapshotStore` + `getBalancePnL()`: Session-scoped P&L from balance snapshots (for charts)
  */
 import { isStablecoinMint } from "./types.js";
+import { computePnlPercent } from "./math-utils.js";
 import { resolveVaultStateForOwner } from "./state-resolver.js";
 import { resolveToken } from "./tokens.js";
-import { computeUtilizationPercent } from "./math-utils.js";
+import { getSigilModuleLogger } from "./logger.js";
 // ─── On-chain P&L (lifetime) ────────────────────────────────────────────────
 /**
  * Pure P&L computation from an already-resolved vault state. No RPC.
@@ -23,7 +24,7 @@ export function getVaultPnLFromState(state) {
     const currentBalance = state.stablecoinBalances.usdc + state.stablecoinBalances.usdt;
     const netInvestment = totalDeposited - totalWithdrawn;
     const pnl = currentBalance - netInvestment;
-    const pnlPercent = computeUtilizationPercent(pnl, netInvestment);
+    const pnlPercent = computePnlPercent(pnl, netInvestment);
     return {
         totalDeposited,
         totalWithdrawn,
@@ -146,26 +147,42 @@ export class BalanceSnapshotStore {
             maxEntries: this.maxEntries,
         });
     }
+    /**
+     * Reconstruct a BalanceSnapshotStore from its JSON serialization.
+     *
+     * F12 fix (type-design-analyzer): wraps BigInt() calls in try/catch so
+     * corrupted JSON surfaces a domain-relevant error instead of raw
+     * SyntaxError from BigInt("not-a-number").
+     */
     static fromJSON(json) {
         const data = JSON.parse(json);
         const maxEntries = Number.isInteger(data.maxEntries)
             ? data.maxEntries
             : 144;
         const store = new BalanceSnapshotStore(maxEntries);
+        const safeBigInt = (val, field) => {
+            try {
+                return BigInt(val);
+            }
+            catch {
+                getSigilModuleLogger().warn(`[@usesigil/kit/BalanceSnapshotStore.fromJSON] Failed to parse bigint for "${field}": ${String(val).slice(0, 50)} — using 0n`);
+                return 0n;
+            }
+        };
         if (data.baseline) {
             store.baseline = {
-                timestamp: BigInt(data.baseline.timestamp),
+                timestamp: safeBigInt(data.baseline.timestamp, "baseline.timestamp"),
                 balances: data.baseline.balances.map((b) => ({
                     ...b,
-                    balance: BigInt(b.balance),
+                    balance: safeBigInt(b.balance, "baseline.balance"),
                 })),
             };
         }
-        for (const snap of data.snapshots) {
-            const ts = BigInt(snap.timestamp);
-            const bals = snap.balances.map((b) => ({
+        for (const snap of data.snapshots ?? []) {
+            const ts = safeBigInt(snap.timestamp, "snapshot.timestamp");
+            const bals = (snap.balances ?? []).map((b) => ({
                 ...b,
-                balance: BigInt(b.balance),
+                balance: safeBigInt(b.balance, "snapshot.balance"),
             }));
             store.snapshots.set(ts, bals);
             store.orderedTimestamps.push(ts);
@@ -194,7 +211,7 @@ export function getBalancePnL(store, network = "mainnet-beta") {
     const startBalance = sumStablecoins(baseline.balances);
     const currentBalance = sumStablecoins(latest.balances);
     const delta = currentBalance - startBalance;
-    const percentChange = computeUtilizationPercent(delta, startBalance);
+    const percentChange = computePnlPercent(delta, startBalance);
     return { startBalance, currentBalance, delta, percentChange };
 }
 //# sourceMappingURL=balance-tracker.js.map

package/dist/balance-tracker.js.map

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