@eco-incorp/sauce 0.99.0

package/sdk/dist/routes/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * eco-routes runtime schema — CURRENT/DEPLOYED shape (not the unmerged v3).
+ *
+ * Isolated in its own file so a future v3 reward-leg model is a one-file swap:
+ * only this file and `intent.ts` (the assembly seam) know the current field
+ * names. Nothing else in `routes/` depends on the exact shape beyond what's
+ * declared here.
+ *
+ * Deliberately schema-only: no ABI/Borsh encoding lives here (that's E3.2),
+ * and no Sauce-bytecode slotting into `route.calls` (that's E3.3).
+ */
+import type { Hex } from "viem";
+export type { Hex };
+/**
+ * bytes32-normalized 0x-hex address, the eco-routes cross-VM address format.
+ * An EVM 20-byte address is left-padded to 32 bytes; an SVM 32-byte pubkey
+ * passes through unchanged. See `normalize.ts#toUniversalAddress`.
+ */
+export type UniversalAddress = Hex;
+export interface TokenAmount {
+    readonly token: UniversalAddress;
+    readonly amount: bigint;
+}
+/**
+ * Unified call shape. SVM's on-chain `Call` has no `value` field — that
+ * narrowing (dropping `value` for an SVM leg, or rejecting a nonzero one) is
+ * an SVM-encode-time (E3.2) concern, deliberately NOT modeled here so this
+ * layer stays engine-agnostic.
+ */
+export interface Call {
+    readonly target: UniversalAddress;
+    readonly data: Hex;
+    readonly value: bigint;
+}
+export interface Route {
+    readonly salt: Hex;
+    readonly deadline: bigint;
+    readonly portal: UniversalAddress;
+    readonly nativeAmount: bigint;
+    readonly tokens: readonly TokenAmount[];
+    readonly calls: readonly Call[];
+}
+export interface Reward {
+    readonly deadline: bigint;
+    readonly creator: UniversalAddress;
+    readonly prover: UniversalAddress;
+    readonly nativeAmount: bigint;
+    readonly tokens: readonly TokenAmount[];
+}
+export interface Intent {
+    readonly destination: bigint;
+    readonly sourceChainId: bigint;
+    readonly route: Route;
+    readonly reward: Reward;
+}
+/** Loosened address input: 20-byte EVM hex, 32-byte hex, or an already-typed UniversalAddress. */
+export type AddressInput = Hex | UniversalAddress;
+export interface TokenAmountInput {
+    readonly token: AddressInput;
+    readonly amount: bigint | number | string;
+}
+export interface CallInput {
+    readonly target: AddressInput;
+    readonly data: Hex;
+    readonly value?: bigint | number | string;
+}
+/** Caller-facing, widened `Route` — what a `.<DestChain>(route)` call accepts. */
+export interface RouteInput {
+    readonly salt?: Hex;
+    readonly deadline: bigint | number | string;
+    readonly portal: AddressInput;
+    readonly nativeAmount?: bigint | number | string;
+    readonly tokens?: readonly TokenAmountInput[];
+    readonly calls?: readonly CallInput[];
+}
+/** Caller-facing, widened `Reward` — what a `.route(reward)` call accepts. */
+export interface RewardInput {
+    readonly deadline: bigint | number | string;
+    readonly creator: AddressInput;
+    readonly prover: AddressInput;
+    readonly nativeAmount?: bigint | number | string;
+    readonly tokens?: readonly TokenAmountInput[];
+}
+//# sourceMappingURL=types.d.ts.map

package/sdk/dist/routes/types.d.ts.map

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

package/sdk/dist/routes/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/sdk/dist/routes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/routes/types.ts"],"names":[],"mappings":""}

package/sdk/dist/routes/vault.d.ts

@@ -0,0 +1,60 @@
+/**
+ * eco-routes V2 vault address prediction — the off-chain twin of
+ * `IntentSource._getVault(bytes32 intentHash)`:
+ *
+ * ```solidity
+ * function _getVault(bytes32 intentHash) internal view returns (address) {
+ *     return VAULT_IMPLEMENTATION.predict(intentHash, CREATE2_PREFIX);
+ * }
+ * ```
+ *
+ * where `Clones.predict` (OpenZeppelin) is a plain CREATE2 address derivation:
+ *
+ * ```
+ * address = last20Bytes(keccak256(prefix ++ deployer ++ salt ++ initCodeHash))
+ * ```
+ *
+ * with `deployer = Portal` (the calling contract — `predict` is an internal library fn, called from
+ * `IntentSource`, and `Portal is IntentSource, Inbox, Semver`), `salt = intentHash` itself (no
+ * further hashing — confirmed against `_getVault`'s own call above), and `prefix = CREATE2_PREFIX`
+ * (`0xff` for EVM Portal deployments; Portal's constructor is `IntentSource(address(new Vault()),
+ * bytes1(0xff))`).
+ *
+ * `initCodeHash = keccak256(type(Proxy).creationCode ++ abi.encode(implementation))` — this is
+ * SHIPPED AS EXPLICIT CONFIG (`VaultConfig.vaultInitCodeHash`), never a baked constant:
+ * `type(Proxy).creationCode` depends on the exact solc version + optimizer settings used to deploy
+ * Portal, and eco-routes commits no artifacts on `main` to derive it from. Obtain it from a real
+ * deployment (or verify against a live `Portal.intentVaultAddress(intent)` call) before trusting a
+ * `predictVaultAddress` result against any real chain — see this epic's design doc's `openQuestions`.
+ *
+ * DO NOT confuse this with eco-routes' own (superseded) `utils/intent.ts#intentVaultAddress` helper:
+ * that models `salt = routeHash` with a Vault deployed with `(intentHash, reward)` constructor args,
+ * which contradicts the real, zero-arg `Vault` constructor and the `Clones`/minimal-proxy scheme
+ * `_getVault` actually uses. The Solidity above is the only ground truth this file follows.
+ */
+import { type Hex } from "viem";
+import type { AddressInput } from "./types.js";
+export interface VaultConfig {
+    /** The Portal contract — the CREATE2 deployer in the formula above. */
+    readonly portal: AddressInput;
+    /** `keccak256(type(Proxy).creationCode ++ abi.encode(vaultImplementation))` — see the module doc;
+     *  never derived here, always caller-supplied. */
+    readonly vaultInitCodeHash: Hex;
+    /** CREATE2 prefix byte. Defaults to `0xff` (the live EVM Portal deployments' `CREATE2_PREFIX`;
+     *  `0x41` is `PortalTron`'s, out of scope here). */
+    readonly prefix?: Hex;
+}
+/**
+ * The off-chain twin of `IntentSource._getVault(intentHash)` -> `Clones.predict(intentHash,
+ * CREATE2_PREFIX)`. Throws (rather than silently computing against a missing/malformed
+ * `vaultInitCodeHash`) since there is no safe baked default — see the module doc.
+ */
+export declare function predictVaultAddress(intentHash: Hex, config: VaultConfig): Hex;
+/**
+ * `keccak256(proxyCreationCode ++ abi.encode(implementation))` — the `initCodeHash` half of the
+ * `Clones.predict` formula, for a caller who has the real `type(Proxy).creationCode` bytes (e.g.
+ * pulled from a deployment artifact) and only needs the implementation-address encoding step done
+ * correctly.
+ */
+export declare function vaultInitCodeHash(proxyCreationCode: Hex, implementation: AddressInput): Hex;
+//# sourceMappingURL=vault.d.ts.map

package/sdk/dist/routes/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/routes/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAML,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAId,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;sDACkD;IAClD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC;IAChC;wDACoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC;CACvB;AAgBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,GAAG,GAAG,CAkB7E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,iBAAiB,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,GAAG,GAAG,CAS3F"}

package/sdk/dist/routes/vault.js

@@ -0,0 +1,84 @@
+/**
+ * eco-routes V2 vault address prediction — the off-chain twin of
+ * `IntentSource._getVault(bytes32 intentHash)`:
+ *
+ * ```solidity
+ * function _getVault(bytes32 intentHash) internal view returns (address) {
+ *     return VAULT_IMPLEMENTATION.predict(intentHash, CREATE2_PREFIX);
+ * }
+ * ```
+ *
+ * where `Clones.predict` (OpenZeppelin) is a plain CREATE2 address derivation:
+ *
+ * ```
+ * address = last20Bytes(keccak256(prefix ++ deployer ++ salt ++ initCodeHash))
+ * ```
+ *
+ * with `deployer = Portal` (the calling contract — `predict` is an internal library fn, called from
+ * `IntentSource`, and `Portal is IntentSource, Inbox, Semver`), `salt = intentHash` itself (no
+ * further hashing — confirmed against `_getVault`'s own call above), and `prefix = CREATE2_PREFIX`
+ * (`0xff` for EVM Portal deployments; Portal's constructor is `IntentSource(address(new Vault()),
+ * bytes1(0xff))`).
+ *
+ * `initCodeHash = keccak256(type(Proxy).creationCode ++ abi.encode(implementation))` — this is
+ * SHIPPED AS EXPLICIT CONFIG (`VaultConfig.vaultInitCodeHash`), never a baked constant:
+ * `type(Proxy).creationCode` depends on the exact solc version + optimizer settings used to deploy
+ * Portal, and eco-routes commits no artifacts on `main` to derive it from. Obtain it from a real
+ * deployment (or verify against a live `Portal.intentVaultAddress(intent)` call) before trusting a
+ * `predictVaultAddress` result against any real chain — see this epic's design doc's `openQuestions`.
+ *
+ * DO NOT confuse this with eco-routes' own (superseded) `utils/intent.ts#intentVaultAddress` helper:
+ * that models `salt = routeHash` with a Vault deployed with `(intentHash, reward)` constructor args,
+ * which contradicts the real, zero-arg `Vault` constructor and the `Clones`/minimal-proxy scheme
+ * `_getVault` actually uses. The Solidity above is the only ground truth this file follows.
+ */
+import { encodeAbiParameters, encodePacked, getAddress, hexToBytes, keccak256, } from "viem";
+import { denormalizeToEvm } from "./encode.js";
+import { toUniversalAddress } from "./normalize.js";
+function assertBytes32(value, label) {
+    const bytes = hexToBytes(value);
+    if (bytes.length !== 32) {
+        throw new Error(`${label}: expected 32 bytes, got ${bytes.length} bytes ('${value}')`);
+    }
+}
+function assertByte1(value, label) {
+    const bytes = hexToBytes(value);
+    if (bytes.length !== 1) {
+        throw new Error(`${label}: expected exactly 1 byte, got ${bytes.length} bytes ('${value}')`);
+    }
+}
+/**
+ * The off-chain twin of `IntentSource._getVault(intentHash)` -> `Clones.predict(intentHash,
+ * CREATE2_PREFIX)`. Throws (rather than silently computing against a missing/malformed
+ * `vaultInitCodeHash`) since there is no safe baked default — see the module doc.
+ */
+export function predictVaultAddress(intentHash, config) {
+    assertBytes32(intentHash, "intentHash");
+    if (config.vaultInitCodeHash === undefined || config.vaultInitCodeHash === null) {
+        throw new Error("predictVaultAddress: config.vaultInitCodeHash is required (no baked default — see vault.ts's module doc)");
+    }
+    assertBytes32(config.vaultInitCodeHash, "vaultInitCodeHash");
+    const prefix = config.prefix ?? "0xff";
+    assertByte1(prefix, "prefix");
+    const portal = denormalizeToEvm(toUniversalAddress(config.portal));
+    const packed = encodePacked(["bytes1", "address", "bytes32", "bytes32"], [prefix, portal, intentHash, config.vaultInitCodeHash]);
+    const digest = keccak256(packed);
+    return getAddress(`0x${digest.slice(-40)}`);
+}
+/**
+ * `keccak256(proxyCreationCode ++ abi.encode(implementation))` — the `initCodeHash` half of the
+ * `Clones.predict` formula, for a caller who has the real `type(Proxy).creationCode` bytes (e.g.
+ * pulled from a deployment artifact) and only needs the implementation-address encoding step done
+ * correctly.
+ */
+export function vaultInitCodeHash(proxyCreationCode, implementation) {
+    const implAddress = denormalizeToEvm(toUniversalAddress(implementation));
+    const encodedImpl = encodeAbiParameters([{ type: "address" }], [implAddress]);
+    const bytes = hexToBytes(proxyCreationCode);
+    const implBytes = hexToBytes(encodedImpl);
+    const combined = new Uint8Array(bytes.length + implBytes.length);
+    combined.set(bytes, 0);
+    combined.set(implBytes, bytes.length);
+    return keccak256(combined);
+}
+//# sourceMappingURL=vault.js.map

package/sdk/dist/routes/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/routes/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,GAEV,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAcpD,SAAS,aAAa,CAAC,KAAU,EAAE,KAAa;IAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4BAA4B,KAAK,CAAC,MAAM,YAAY,KAAK,IAAI,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAU,EAAE,KAAa;IAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kCAAkC,KAAK,CAAC,MAAM,YAAY,KAAK,IAAI,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAe,EAAE,MAAmB;IACtE,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAC;IACJ,CAAC;IACD,aAAa,CAAC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IACvC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,YAAY,CACzB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAC3C,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,iBAAiB,CAAC,CACvD,CAAC;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAQ,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,iBAAsB,EAAE,cAA4B;IACpF,MAAM,WAAW,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjE,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/sdk/dist/skills/loader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Load the master protocol index skill file.
+ * Returns markdown content with all protocols, categories, operations, and chain coverage.
+ */
+export declare function getProtocolIndex(): string;
+/**
+ * Load a specific protocol's skill file by slug.
+ * Returns markdown describing the protocol, its operations,
+ * SauceScript examples, contract addresses, and ABI methods.
+ *
+ * The slug is matched against `listSkillSlugs()` before it ever reaches `join`, so it can only name
+ * a skill file this package ships — a caller-supplied path can never escape `skillsDir`. Anything
+ * else, including a slug whose file is unreadable, surfaces as the same not-found error.
+ */
+export declare function getProtocolSkill(slug: string): string;
+/**
+ * List all available protocol skill slugs.
+ */
+export declare function listSkillSlugs(): string[];
+/**
+ * Absolute path to the skills directory (for direct file access).
+ */
+export declare const SKILLS_DIR: string;
+//# sourceMappingURL=loader.d.ts.map

package/sdk/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAKzC;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,QAAY,CAAC"}

package/sdk/dist/skills/loader.js

@@ -0,0 +1,51 @@
+import { readFileSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+// At runtime this file is at dist/skills/loader.js, so package root is ../..
+// The .md files live at src/skills/ which ships with the package
+const thisDir = dirname(fileURLToPath(import.meta.url));
+const packageRoot = join(thisDir, "..", "..");
+const skillsDir = join(packageRoot, "src", "skills");
+/**
+ * Load the master protocol index skill file.
+ * Returns markdown content with all protocols, categories, operations, and chain coverage.
+ */
+export function getProtocolIndex() {
+    return readFileSync(join(skillsDir, "index.md"), "utf-8");
+}
+/**
+ * Load a specific protocol's skill file by slug.
+ * Returns markdown describing the protocol, its operations,
+ * SauceScript examples, contract addresses, and ABI methods.
+ *
+ * The slug is matched against `listSkillSlugs()` before it ever reaches `join`, so it can only name
+ * a skill file this package ships — a caller-supplied path can never escape `skillsDir`. Anything
+ * else, including a slug whose file is unreadable, surfaces as the same not-found error.
+ */
+export function getProtocolSkill(slug) {
+    if (!listSkillSlugs().includes(slug))
+        throw unknownSlug(slug);
+    try {
+        return readFileSync(join(skillsDir, `${slug}.md`), "utf-8");
+    }
+    catch {
+        throw unknownSlug(slug);
+    }
+}
+/**
+ * List all available protocol skill slugs.
+ */
+export function listSkillSlugs() {
+    return readdirSync(skillsDir)
+        .filter((f) => f.endsWith(".md") && f !== "index.md")
+        .map((f) => f.replace(".md", ""))
+        .sort();
+}
+/**
+ * Absolute path to the skills directory (for direct file access).
+ */
+export const SKILLS_DIR = skillsDir;
+function unknownSlug(slug) {
+    return new Error(`No skill file found for protocol "${slug}". Check listSkillSlugs() for valid slugs.`);
+}
+//# sourceMappingURL=loader.js.map

package/sdk/dist/skills/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,6EAA6E;AAC7E,iEAAiE;AACjE,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAErD;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC,SAAS,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAEpC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,KAAK,CACd,qCAAqC,IAAI,4CAA4C,CACtF,CAAC;AACJ,CAAC"}

package/sdk/dist/std/token/erc20.abi.json

@@ -0,0 +1,197 @@
+[
+  {
+    "name": "transfer",
+    "type": "function",
+    "stateMutability": "nonpayable",
+    "inputs": [
+      {
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool"
+      }
+    ]
+  },
+  {
+    "name": "approve",
+    "type": "function",
+    "stateMutability": "nonpayable",
+    "inputs": [
+      {
+        "name": "spender",
+        "type": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool"
+      }
+    ]
+  },
+  {
+    "name": "transferFrom",
+    "type": "function",
+    "stateMutability": "nonpayable",
+    "inputs": [
+      {
+        "name": "from",
+        "type": "address"
+      },
+      {
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool"
+      }
+    ]
+  },
+  {
+    "name": "balanceOf",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [
+      {
+        "name": "account",
+        "type": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256"
+      }
+    ]
+  },
+  {
+    "name": "allowance",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address"
+      },
+      {
+        "name": "spender",
+        "type": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256"
+      }
+    ]
+  },
+  {
+    "name": "totalSupply",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256"
+      }
+    ]
+  },
+  {
+    "name": "name",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "name": "symbol",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "name": "decimals",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint8"
+      }
+    ]
+  },
+  {
+    "name": "Transfer",
+    "type": "event",
+    "inputs": [
+      {
+        "name": "from",
+        "type": "address",
+        "indexed": true
+      },
+      {
+        "name": "to",
+        "type": "address",
+        "indexed": true
+      },
+      {
+        "name": "value",
+        "type": "uint256",
+        "indexed": false
+      }
+    ]
+  },
+  {
+    "name": "Approval",
+    "type": "event",
+    "inputs": [
+      {
+        "name": "owner",
+        "type": "address",
+        "indexed": true
+      },
+      {
+        "name": "spender",
+        "type": "address",
+        "indexed": true
+      },
+      {
+        "name": "value",
+        "type": "uint256",
+        "indexed": false
+      }
+    ]
+  }
+]

package/sdk/dist/std/token/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@sauce/token",
+  "version": "0.0.0",
+  "private": true,
+  "description": "SauceScript ERC20/SPL token library. `main` names the NEUTRAL BASE the compiler suffixes per target (token.evm.js / token.svm.js) — there is deliberately no token.js: a token program is inherently target-specific, so there is no target-neutral body, and shipping an empty or guessed-signature neutral file would turn a missing arm into a confusing missing-export (or, worse, a silently wrong compile) instead of a clear failure to import the package.",
+  "main": "token.js"
+}

package/sdk/dist/std/token/token.evm.js

@@ -0,0 +1,42 @@
+// @sauce/token — EVM arm (ERC20).
+// Selected by the compiler for `--target evm`. Every method is an ordinary ERC20 call over the
+// `CALL`/`STATIC` path; `token`/`account` addresses ride calldata like any other value.
+import ERC20 from "./erc20.abi.json";
+
+export function balanceOf(token: Address, account: Account): Uint256 {
+  return ERC20.at(token).balanceOf(account);
+}
+
+export function totalSupply(token: Address): Uint256 {
+  return ERC20.at(token).totalSupply();
+}
+
+export function decimals(token: Address): Uint256 {
+  return ERC20.at(token).decimals();
+}
+
+export function allowance(token: Address, owner: Address, spender: Address): Uint256 {
+  return ERC20.at(token).allowance(owner, spender);
+}
+
+// The writes are `: void` and DISCARD the ERC20 `bool` return — they don't `require` it. Real
+// SafeERC20 is "empty returndata OR the decoded word is true", but the compiler exposes no
+// returndatasize primitive (the only raw-returndata access is `evm.call`, which would abandon the
+// ABI-aware `ERC20.at().method()` path this arm is built on), so "empty OR true" isn't expressible
+// here. A plain `require(...transfer(...))` reverts on a USDT-style no-returndata token — the decode
+// clamps the missing word to 0/false and the `require` then reverts a transfer that actually
+// succeeded — so the bool is dropped: USDT compatibility beats catching a rare non-reverting-false
+// token. The CALL's side effect (and any genuine revert from the token) still happens; only the
+// return word is ignored. TODO: revisit once the compiler gains a returndatasize op to express real
+// SafeERC20 (tracked as the EVM SafeERC20 limitation in README's cross-target divergences).
+export function transfer(token: Address, to: Address, amount: Uint256): void {
+  ERC20.at(token).transfer(to, amount);
+}
+
+export function transferFrom(token: Address, from: Address, to: Address, amount: Uint256): void {
+  ERC20.at(token).transferFrom(from, to, amount);
+}
+
+export function approve(token: Address, spender: Address, amount: Uint256): void {
+  ERC20.at(token).approve(spender, amount);
+}