gulltoppr 0.1.0

package/README.md

@@ -0,0 +1,72 @@
+# gulltoppr
+
+Typed TypeScript client for the [gulltoppr](../README.md) — resolve any
+contract's ABI (verified *or* unverified, via the heimdall decompile rung) and
+prepare safe, simulated, non-custodial interactions. The typed client over the REST
+surface in [`../SPEC.md`](../SPEC.md) §4.
+
+```bash
+npm install gulltoppr viem
+```
+
+## Usage
+
+```ts
+import { AbiNinja } from "gulltoppr";
+
+// baseUrl defaults to the live engine; pass it only to override.
+const ninja = new AbiNinja({ baseUrl: "https://gulltoppr.fly.dev" });
+
+// Resolve — ABI is secondary; the capability manifest + provenance are the point.
+const r = await ninja.resolveAbi("base", "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+if (r.provenance.confidence === "decompiled") {
+  console.warn("Decompiled ABI — names are inferred:", r.provenance.notes);
+}
+console.log(r.interface.reads.map((f) => f.signature));   // the "buttons"
+
+// Read (no wallet)
+const { decoded } = await ninja.read("base", r.address, "balanceOf", ["0xabc…"]);
+
+// Prepare a write — returns an UNSIGNED tx + simulation + deeplink. Signs nothing.
+const prep = await ninja.prepareTx("base", r.address, "transfer", ["0xdef…", "1000000"], {
+  from: "0xMyWallet…",
+});
+console.log(prep.human_summary, prep.warnings);
+// → hand prep.deeplink to the user; they sign in their own wallet.
+```
+
+### `contract()` — resolve once, then act (viem-flavoured)
+
+```ts
+const usdc = ninja.contract("base", "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913");
+const meta = await usdc.resolve();              // memoized
+const bal = await usdc.read("balanceOf", ["0xabc…"]);
+const tx = await usdc.prepare("approve", ["0xspender…", "1000000"], { from: "0xme…" });
+```
+
+## API
+
+| method | verb |
+|--------|------|
+| `resolveAbi(chain, address, opts?)` | resolve_abi |
+| `read(chain, address, fn, args?, opts?)` | read_contract |
+| `encode(chain, address, fn, args?, opts?)` | encode_call |
+| `simulate(chain, { from, address/function/args \| to/data, value? }, opts?)` | simulate |
+| `prepareTx(chain, address, fn, args, { from, value?, rpcUrl? })` | prepare_tx |
+| `decodeTx(chain, txHash, opts?)` | decode_tx |
+| `resolveName(nameOrAddress, chain?)` | resolve_name |
+| `contract(chain, address)` | ergonomic handle |
+
+- `chain` is an alias (`"ethereum"`, `"base"`, …) or a numeric id.
+- `opts.rpcUrl` overrides the engine's RPC (required for `local`/31337).
+- Errors throw `AbiNinjaError` with a stable `.code` (`NOT_A_VIEW_FN`,
+  `AMBIGUOUS_FUNCTION` with `.details.candidates`, `ABI_NOT_FOUND`, …) and `.status`.
+- Bigints arrive as decimal strings (the engine serializes them on the wire).
+
+## Build
+
+```bash
+npm run build       # tsc → dist/ (js + d.ts)
+npm run typecheck
+npm test            # vitest — client tests with an injected fetch (no network)
+```

package/dist/client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * AbiNinja — typed client for the abi.ninja engine REST surface (SPEC §4).
+ *
+ * Low-level verbs mirror the seven engine verbs 1:1. A `contract()` helper gives a
+ * viem-flavoured ergonomic surface (resolve once, then read/encode/prepare).
+ */
+import type { Address, Hex } from "viem";
+import type { AbiResult, ChainInput, DecodeTxResult, EncodeResult, PreparedTx, ReadResult, ResolveNameResult, Simulation } from "./types.js";
+export interface AbiNinjaOptions {
+    /** Engine base URL. Default: https://gulltoppr.fly.dev */
+    baseUrl?: string;
+    /** Inject a custom fetch (tests, Node < 18, proxies). Default: global fetch. */
+    fetch?: typeof globalThis.fetch;
+    /** Extra headers on every request (e.g. an API key). */
+    headers?: Record<string, string>;
+}
+export interface CallOpts {
+    /** Override the RPC the engine uses for this chain (required for local/31337). */
+    rpcUrl?: string;
+}
+interface SimulateArgs {
+    from: Address;
+    address?: Address;
+    function?: string;
+    args?: unknown[];
+    to?: Address;
+    data?: Hex;
+    value?: string;
+}
+export declare class AbiNinja {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly headers;
+    constructor(opts?: AbiNinjaOptions);
+    /** resolve_abi — ABI + capability manifest + provenance + proxy chain. */
+    resolveAbi(chain: ChainInput, address: Address, opts?: CallOpts): Promise<AbiResult>;
+    /** read_contract — call a view/pure function, get the decoded result. */
+    read(chain: ChainInput, address: Address, fn: string, args?: unknown[], opts?: CallOpts): Promise<ReadResult>;
+    /** encode_call — function + args → calldata. */
+    encode(chain: ChainInput, address: Address, fn: string, args?: unknown[], opts?: CallOpts & {
+        value?: string;
+    }): Promise<EncodeResult>;
+    /** simulate — high-level {address,function,args} or raw {to,data}. */
+    simulate(chain: ChainInput, args: SimulateArgs, opts?: CallOpts): Promise<Simulation>;
+    /** prepare_tx — the non-custodial hand-off: unsigned tx + simulation + summary + deeplink. */
+    prepareTx(chain: ChainInput, address: Address, fn: string, args: unknown[], opts: CallOpts & {
+        from: Address;
+        value?: string;
+    }): Promise<PreparedTx>;
+    /** decode_tx — "explain what this tx did." */
+    decodeTx(chain: ChainInput, txHash: string, opts?: CallOpts): Promise<DecodeTxResult>;
+    /** resolve_name — ENS name → address, or address → primary ENS name. */
+    resolveName(nameOrAddress: string, chain?: ChainInput): Promise<ResolveNameResult>;
+    /** Ergonomic handle: resolve once, then read/encode/prepare against this contract. */
+    contract(chain: ChainInput, address: Address): Contract;
+    private url;
+    private get;
+    private post;
+    private request;
+}
+/** A resolved-on-demand handle to one contract — viem `getContract` flavour. */
+export declare class Contract {
+    private readonly client;
+    readonly chain: ChainInput;
+    readonly address: Address;
+    private resolved?;
+    constructor(client: AbiNinja, chain: ChainInput, address: Address);
+    /** Resolve (and memoize) this contract's ABI + manifest. */
+    resolve(opts?: CallOpts): Promise<AbiResult>;
+    read(fn: string, args?: unknown[], opts?: CallOpts): Promise<ReadResult>;
+    encode(fn: string, args?: unknown[], opts?: CallOpts & {
+        value?: string;
+    }): Promise<EncodeResult>;
+    prepare(fn: string, args: unknown[], opts: CallOpts & {
+        from: Address;
+        value?: string;
+    }): Promise<PreparedTx>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,116 @@
+import { AbiNinjaError } from "./errors.js";
+export class AbiNinja {
+    baseUrl;
+    fetchImpl;
+    headers;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? "https://gulltoppr.fly.dev").replace(/\/$/, "");
+        if (!opts.fetch && !globalThis.fetch) {
+            throw new Error("No fetch available; pass { fetch } in AbiNinjaOptions.");
+        }
+        // Native browser fetch must be invoked with `this === window`/global; calling it
+        // as a method (this.fetchImpl(...)) detaches it and throws "Illegal invocation".
+        // Bind the default global fetch; leave a caller-provided fetch untouched.
+        this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);
+        this.headers = opts.headers ?? {};
+    }
+    // ── verbs ───────────────────────────────────────────────────────────────────
+    /** resolve_abi — ABI + capability manifest + provenance + proxy chain. */
+    resolveAbi(chain, address, opts) {
+        return this.get(`/v1/${enc(chain)}/${address}/abi`, opts);
+    }
+    /** read_contract — call a view/pure function, get the decoded result. */
+    read(chain, address, fn, args = [], opts) {
+        return this.post(`/v1/${enc(chain)}/${address}/read`, { function: fn, args }, opts);
+    }
+    /** encode_call — function + args → calldata. */
+    encode(chain, address, fn, args = [], opts) {
+        return this.post(`/v1/${enc(chain)}/${address}/encode`, { function: fn, args, value: opts?.value }, opts);
+    }
+    /** simulate — high-level {address,function,args} or raw {to,data}. */
+    simulate(chain, args, opts) {
+        return this.post(`/v1/${enc(chain)}/simulate`, args, opts);
+    }
+    /** prepare_tx — the non-custodial hand-off: unsigned tx + simulation + summary + deeplink. */
+    prepareTx(chain, address, fn, args, opts) {
+        return this.post(`/v1/${enc(chain)}/${address}/prepare`, { function: fn, args, from: opts.from, value: opts.value }, opts);
+    }
+    /** decode_tx — "explain what this tx did." */
+    decodeTx(chain, txHash, opts) {
+        return this.get(`/v1/${enc(chain)}/tx/${txHash}`, opts);
+    }
+    /** resolve_name — ENS name → address, or address → primary ENS name. */
+    resolveName(nameOrAddress, chain = "ethereum") {
+        const isAddr = /^0x[0-9a-fA-F]{40}$/.test(nameOrAddress);
+        const path = isAddr
+            ? `/v1/${enc(chain)}/name/by-address/${nameOrAddress}`
+            : `/v1/${enc(chain)}/name/${encodeURIComponent(nameOrAddress)}`;
+        return this.get(path);
+    }
+    /** Ergonomic handle: resolve once, then read/encode/prepare against this contract. */
+    contract(chain, address) {
+        return new Contract(this, chain, address);
+    }
+    // ── transport ─────────────────────────────────────────────────────────────────
+    url(path, opts) {
+        const u = this.baseUrl + path;
+        return opts?.rpcUrl ? `${u}?rpc_url=${encodeURIComponent(opts.rpcUrl)}` : u;
+    }
+    async get(path, opts) {
+        return this.request("GET", this.url(path, opts));
+    }
+    async post(path, body, opts) {
+        return this.request("POST", this.url(path, opts), body);
+    }
+    async request(method, url, body) {
+        let res;
+        try {
+            res = await this.fetchImpl(url, {
+                method,
+                headers: { "content-type": "application/json", ...this.headers },
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+            });
+        }
+        catch (e) {
+            throw new AbiNinjaError("NETWORK", `Request to ${url} failed: ${e.message}`, 0);
+        }
+        const text = await res.text();
+        const json = text ? JSON.parse(text) : undefined;
+        if (!res.ok) {
+            const err = json?.error;
+            throw new AbiNinjaError(err?.code ?? "INTERNAL", err?.message ?? `HTTP ${res.status}`, res.status, err?.details);
+        }
+        return json;
+    }
+}
+/** A resolved-on-demand handle to one contract — viem `getContract` flavour. */
+export class Contract {
+    client;
+    chain;
+    address;
+    resolved;
+    constructor(client, chain, address) {
+        this.client = client;
+        this.chain = chain;
+        this.address = address;
+    }
+    /** Resolve (and memoize) this contract's ABI + manifest. */
+    resolve(opts) {
+        this.resolved ??= this.client.resolveAbi(this.chain, this.address, opts);
+        return this.resolved;
+    }
+    read(fn, args = [], opts) {
+        return this.client.read(this.chain, this.address, fn, args, opts);
+    }
+    encode(fn, args = [], opts) {
+        return this.client.encode(this.chain, this.address, fn, args, opts);
+    }
+    prepare(fn, args, opts) {
+        return this.client.prepareTx(this.chain, this.address, fn, args, opts);
+    }
+}
+/** Chain segment: numbers and alias strings both pass through encodeURIComponent. */
+function enc(chain) {
+    return encodeURIComponent(String(chain));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Client-side error — mirrors the engine's error envelope (SPEC §7). Carries the
+ * stable machine `code` so callers can branch on it (e.g. retry on RPC_ERROR,
+ * surface AMBIGUOUS_FUNCTION candidates).
+ */
+export type ErrorCode = "INVALID_ADDRESS" | "INVALID_ARGS" | "UNKNOWN_CHAIN" | "AMBIGUOUS_FUNCTION" | "FUNCTION_NOT_FOUND" | "NOT_A_VIEW_FN" | "ABI_NOT_FOUND" | "DECOMPILE_FAILED" | "RPC_ERROR" | "UPSTREAM_TIMEOUT" | "RATE_LIMITED" | "INTERNAL" | "NETWORK";
+export declare class AbiNinjaError extends Error {
+    readonly code: ErrorCode;
+    readonly status: number;
+    readonly details?: Record<string, unknown>;
+    constructor(code: ErrorCode, message: string, status: number, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,SAAS,CAAC;AAEd,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOhG"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class AbiNinjaError extends Error {
+    code;
+    status;
+    details;
+    constructor(code, message, status, details) {
+        super(message);
+        this.name = "AbiNinjaError";
+        this.code = code;
+        this.status = status;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAY;IAChB,MAAM,CAAS;IACf,OAAO,CAA2B;IAE3C,YAAY,IAAe,EAAE,OAAe,EAAE,MAAc,EAAE,OAAiC;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/** gulltoppr — typed client for the abi.ninja engine. */
+export { AbiNinja, Contract } from "./client.js";
+export type { AbiNinjaOptions, CallOpts } from "./client.js";
+export { AbiNinjaError } from "./errors.js";
+export type { ErrorCode } from "./errors.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+/** gulltoppr — typed client for the abi.ninja engine. */
+export { AbiNinja, Contract } from "./client.js";
+export { AbiNinjaError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Public wire types — the JSON the abi.ninja engine returns (SPEC.md §2). These
+ * mirror the engine's `src/types.ts`; SPEC is the shared source of truth. Primitive
+ * onchain types come from viem so consumers get the same branded `Address`/`Hex`.
+ *
+ * Note on numbers: the engine serializes bigints as decimal strings on the wire, so
+ * fields like `decoded[]` / amounts arrive as strings, not bigints.
+ */
+import type { Abi, Address, Hex } from "viem";
+export type ChainInput = number | string;
+export type ProvenanceSource = "etherscan" | "sourcify" | "proxy-impl" | "heimdall-decompiled" | "4byte";
+export type Confidence = "verified" | "partial" | "decompiled" | "selector-only";
+export interface Provenance {
+    source: ProvenanceSource;
+    confidence: Confidence;
+    verified: boolean;
+    names_synthetic: boolean;
+    natspec: boolean;
+    notes?: string;
+}
+export type ProxyPattern = "eip1967" | "uups" | "transparent" | "beacon" | "diamond" | "minimal-1167" | "unknown";
+export interface ProxyHop {
+    address: Address;
+    role: "proxy" | "implementation" | "beacon" | "facet";
+}
+export interface ProxyChain {
+    is_proxy: true;
+    pattern: ProxyPattern;
+    hops: ProxyHop[];
+    resolved_implementation?: Address;
+}
+export interface IoParam {
+    name: string;
+    type: string;
+}
+export interface ReadCapability {
+    function: string;
+    signature: string;
+    inputs: IoParam[];
+    outputs: IoParam[];
+    names_synthetic: boolean;
+    hint?: string;
+}
+export interface WriteCapability {
+    function: string;
+    signature: string;
+    inputs: IoParam[];
+    payable: boolean;
+    names_synthetic: boolean;
+    hint?: string;
+}
+export interface ContractInterface {
+    reads: ReadCapability[];
+    writes: WriteCapability[];
+}
+export interface TokenMeta {
+    kind: "erc20" | "erc721" | "erc1155" | null;
+    symbol?: string;
+    decimals?: number;
+    name?: string;
+}
+export interface AbiResult {
+    chain: number;
+    address: Address;
+    interface: ContractInterface;
+    abi: Abi;
+    provenance: Provenance;
+    proxy?: ProxyChain;
+    token?: TokenMeta;
+    abi_for: Address;
+    cached: boolean;
+}
+export interface AssetChange {
+    address: Address;
+    token: Address;
+    symbol?: string;
+    delta: string;
+    kind: "erc20" | "erc721" | "erc1155" | "native";
+}
+export interface StateDiffEntry {
+    address: Address;
+    slot_label?: string;
+    before: string;
+    after: string;
+}
+export interface SimLog {
+    address: Address;
+    event?: string;
+    args?: Record<string, unknown>;
+}
+export interface Simulation {
+    success: boolean;
+    gas_used: number;
+    return_value?: {
+        decoded: unknown[];
+        raw: Hex;
+    };
+    state_diff: StateDiffEntry[];
+    asset_changes: AssetChange[];
+    logs: SimLog[];
+    revert?: {
+        reason: string;
+        decoded?: string;
+    };
+}
+export interface UnsignedTx {
+    chainId: number;
+    to: Address;
+    from: Address;
+    data: Hex;
+    value: string;
+    gas?: string;
+}
+export interface PreparedTx {
+    unsigned_tx: UnsignedTx;
+    simulation: Simulation;
+    human_summary: string;
+    deeplink: string;
+    warnings: string[];
+}
+export interface ReadResult {
+    decoded: unknown[];
+    raw: Hex;
+    function_signature: string;
+}
+export interface EncodeResult {
+    data: Hex;
+    function_signature: string;
+}
+export interface DecodeTxResult {
+    chain: number;
+    tx_hash: string;
+    source: string;
+    cached: boolean;
+    decoded: unknown;
+    provenance: {
+        source: string;
+        confidence: "decompiled";
+        verified: false;
+        names_synthetic: true;
+    };
+}
+export interface ResolveNameResult {
+    address?: Address;
+    name?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "gulltoppr",
+  "version": "0.1.0",
+  "description": "Typed client for gulltoppr — let agents interact with any contract on any EVM chain: resolve ABIs (even unverified), read, simulate, and prepare safe non-custodial transactions.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": ["ethereum", "abi", "evm", "viem", "smart-contracts", "agents", "gulltoppr", "mcp"],
+  "homepage": "https://github.com/portdeveloper/gulltoppr",
+  "repository": { "type": "git", "url": "git+https://github.com/portdeveloper/gulltoppr.git", "directory": "sdk" },
+  "license": "MIT",
+  "peerDependencies": {
+    "viem": "^2"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "viem": "^2.21.55",
+    "vitest": "^2.1.8"
+  }
+}