@avaprotocol/sdk-js 2.17.0 → 4.0.0-dev.0

package/dist/v4/auth.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Canonical EIP-191 message template the aggregator's auth handler
+ * verifies. Must match the format documented in the API spec.
+ *
+ * Filled by `buildAuthMessage` below; the SDK exports both halves
+ * (build + sign) so non-SDK callers (web wallets, smart-account
+ * signers) can produce a message that exchanges cleanly.
+ */
+export declare const AUTH_TEMPLATE = "Please sign the below text for ownership verification.\n\nURI: https://app.avaprotocol.org\nChain ID: {chainId}\nVersion: {version}\nIssued At: {issuedAt}\nExpire At: {expireAt}\nWallet: {wallet}";
+export interface BuildAuthMessageInput {
+    /** EOA the JWT will be bound to. Lowercased / checksummed both work. */
+    ownerAddress: string;
+    /**
+     * Chain id to embed in the canonical message. Defaults to
+     * `Chains.EigenLayerAuth` — the auth flow is chain-agnostic, the
+     * embedded id only tells the verifier which chain bucket the
+     * minted JWT belongs to.
+     */
+    chainId?: number;
+    /** SDK version string surfaced in the message (purely informational). */
+    version?: string;
+    /** Issuance timestamp; defaults to `new Date()`. */
+    issuedAt?: Date;
+    /** Token expiry; defaults to 24h from issuedAt. */
+    expireAt?: Date;
+}
+export interface BuiltAuthMessage {
+    readonly message: string;
+    readonly chainId: number;
+    readonly ownerAddress: string;
+    readonly expireAt: Date;
+}
+/**
+ * Build the canonical auth message a wallet must sign. Pure — does
+ * no signing — so it can run in the browser before opening the wallet
+ * popup.
+ */
+export declare function buildAuthMessage(input: BuildAuthMessageInput): BuiltAuthMessage;
+/**
+ * One-shot helper: build the message, sign it with the supplied
+ * private key, and return the payload ready for
+ * `client.auth.exchange()`. Only useful in tests / Node tooling
+ * where the private key is in hand; browser flows use
+ * `buildAuthMessage` + a wallet's `personal_sign`.
+ */
+export declare function signAuthMessage(privateKey: string, input?: Omit<BuildAuthMessageInput, "ownerAddress"> & {
+    ownerAddress?: string;
+}): Promise<{
+    message: string;
+    signature: string;
+    ownerAddress: string;
+    expireAt: Date;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/v4/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/v4/auth.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,wMAOT,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CAc/E;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,CAAC,CAkBvF"}

package/dist/v4/auth.js

@@ -0,0 +1,70 @@
+import { Wallet, getAddress } from "ethers";
+import { Chains } from "./chains";
+/**
+ * Canonical EIP-191 message template the aggregator's auth handler
+ * verifies. Must match the format documented in the API spec.
+ *
+ * Filled by `buildAuthMessage` below; the SDK exports both halves
+ * (build + sign) so non-SDK callers (web wallets, smart-account
+ * signers) can produce a message that exchanges cleanly.
+ */
+export const AUTH_TEMPLATE = `Please sign the below text for ownership verification.
+
+URI: https://app.avaprotocol.org
+Chain ID: {chainId}
+Version: {version}
+Issued At: {issuedAt}
+Expire At: {expireAt}
+Wallet: {wallet}`;
+/**
+ * Build the canonical auth message a wallet must sign. Pure — does
+ * no signing — so it can run in the browser before opening the wallet
+ * popup.
+ */
+export function buildAuthMessage(input) {
+    const issuedAt = input.issuedAt ?? new Date();
+    const expireAt = input.expireAt ?? new Date(issuedAt.getTime() + 24 * 60 * 60 * 1000);
+    const chainId = input.chainId ?? Chains.EigenLayerAuth;
+    // Canonicalize the address so the wire form matches what the
+    // aggregator extracts via crypto.PubkeyToAddress.
+    const ownerAddress = getAddress(input.ownerAddress);
+    const message = AUTH_TEMPLATE
+        .replace("{chainId}", String(chainId))
+        .replace("{version}", input.version ?? "v4-sdk")
+        .replace("{issuedAt}", toRFC3339Millis(issuedAt))
+        .replace("{expireAt}", toRFC3339Millis(expireAt))
+        .replace("{wallet}", ownerAddress);
+    return { message, chainId, ownerAddress, expireAt };
+}
+/**
+ * One-shot helper: build the message, sign it with the supplied
+ * private key, and return the payload ready for
+ * `client.auth.exchange()`. Only useful in tests / Node tooling
+ * where the private key is in hand; browser flows use
+ * `buildAuthMessage` + a wallet's `personal_sign`.
+ */
+export async function signAuthMessage(privateKey, input) {
+    const signer = new Wallet(privateKey);
+    const built = buildAuthMessage({
+        ownerAddress: input?.ownerAddress ?? signer.address,
+        chainId: input?.chainId,
+        version: input?.version,
+        issuedAt: input?.issuedAt,
+        expireAt: input?.expireAt,
+    });
+    // signMessage performs EIP-191 personal_sign — the same prefix
+    // accounts.TextHash uses on the verifier side.
+    const signature = await signer.signMessage(built.message);
+    return {
+        message: built.message,
+        signature,
+        ownerAddress: built.ownerAddress,
+        expireAt: built.expireAt,
+    };
+}
+// toRFC3339Millis renders a Date as `2026-05-25T12:00:00.000Z`. Matches
+// the format the aggregator's verifier parses with the layout
+// `2006-01-02T15:04:05.000Z`.
+function toRFC3339Millis(d) {
+    return d.toISOString().replace(/(\.\d{3})\d*Z$/, "$1Z");
+}

package/dist/v4/builders/nodes.d.ts

@@ -0,0 +1,103 @@
+import type { v4 } from "@avaprotocol/types";
+/**
+ * Typed builders for the Node discriminated union. Same convention
+ * as `Triggers`: each builder returns a plain JSON object shaped
+ * like `v4.Node` (no class instances).
+ *
+ *   import { Nodes } from "@avaprotocol/sdk-js";
+ *   const node = Nodes.customCode({ id: "step1", name: "step1",
+ *     source: "return {ok: true};" });
+ *   await client.workflows.create({ trigger, nodes: [node], ... });
+ */
+export declare const Nodes: Readonly<{
+    ethTransfer(opts: {
+        id: string;
+        name: string;
+        destination: string;
+        amountWei: string;
+        chainId?: number;
+    }): v4.Node;
+    contractWrite(opts: {
+        id: string;
+        name: string;
+        contractAddress: string;
+        contractAbi?: Array<Record<string, unknown>>;
+        methodCalls?: Array<{
+            methodName: string;
+            methodParams?: string[];
+            callData?: string;
+            applyToFields?: string[];
+        }>;
+        callData?: string;
+        isSimulated?: boolean;
+        valueWei?: string;
+        gasLimit?: string;
+        chainId?: number;
+    }): v4.Node;
+    contractRead(opts: {
+        id: string;
+        name: string;
+        contractAddress: string;
+        contractAbi?: Array<Record<string, unknown>>;
+        methodCalls?: Array<{
+            methodName: string;
+            methodParams?: string[];
+            callData?: string;
+            applyToFields?: string[];
+        }>;
+        chainId?: number;
+    }): v4.Node;
+    graphqlQuery(opts: {
+        id: string;
+        name: string;
+        url: string;
+        query: string;
+        variables?: Record<string, string>;
+    }): v4.Node;
+    restApi(opts: {
+        id: string;
+        name: string;
+        url: string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+        body?: string;
+        headers?: Record<string, string>;
+    }): v4.Node;
+    branch(opts: {
+        id: string;
+        name: string;
+        conditions: Array<{
+            id: string;
+            expression: string;
+            type?: "if" | "elseIf" | "else";
+        }>;
+    }): v4.Node;
+    filter(opts: {
+        id: string;
+        name: string;
+        expression: string;
+        inputVariable: string;
+    }): v4.Node;
+    loop(opts: {
+        id: string;
+        name: string;
+        inputVariable: string;
+        iterVar?: string;
+        runner: v4.Node;
+    }): v4.Node;
+    customCode(opts: {
+        id: string;
+        name: string;
+        source: string;
+        lang?: v4.Lang;
+    }): v4.Node;
+    balance(opts: {
+        id: string;
+        name: string;
+        address: string;
+        chain: string;
+        includeSpam?: boolean;
+        includeZeroBalances?: boolean;
+        minUsdValueCents?: number;
+    }): v4.Node;
+}>;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/v4/builders/nodes.d.ts.map

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

package/dist/v4/builders/nodes.js

@@ -0,0 +1,132 @@
+/**
+ * Typed builders for the Node discriminated union. Same convention
+ * as `Triggers`: each builder returns a plain JSON object shaped
+ * like `v4.Node` (no class instances).
+ *
+ *   import { Nodes } from "@avaprotocol/sdk-js";
+ *   const node = Nodes.customCode({ id: "step1", name: "step1",
+ *     source: "return {ok: true};" });
+ *   await client.workflows.create({ trigger, nodes: [node], ... });
+ */
+export const Nodes = Object.freeze({
+    ethTransfer(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "ethTransfer",
+            config: {
+                destination: opts.destination,
+                amount: opts.amountWei,
+                ...(opts.chainId ? { chainId: opts.chainId } : {}),
+            },
+        };
+    },
+    contractWrite(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "contractWrite",
+            config: {
+                contractAddress: opts.contractAddress,
+                ...(opts.contractAbi ? { contractAbi: opts.contractAbi } : {}),
+                ...(opts.methodCalls ? { methodCalls: opts.methodCalls } : {}),
+                ...(opts.callData ? { callData: opts.callData } : {}),
+                ...(opts.isSimulated !== undefined ? { isSimulated: opts.isSimulated } : {}),
+                ...(opts.valueWei ? { value: opts.valueWei } : {}),
+                ...(opts.gasLimit ? { gasLimit: opts.gasLimit } : {}),
+                ...(opts.chainId ? { chainId: opts.chainId } : {}),
+            },
+        };
+    },
+    contractRead(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "contractRead",
+            config: {
+                contractAddress: opts.contractAddress,
+                ...(opts.contractAbi ? { contractAbi: opts.contractAbi } : {}),
+                ...(opts.methodCalls ? { methodCalls: opts.methodCalls } : {}),
+                ...(opts.chainId ? { chainId: opts.chainId } : {}),
+            },
+        };
+    },
+    graphqlQuery(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "graphqlQuery",
+            config: {
+                url: opts.url,
+                query: opts.query,
+                ...(opts.variables ? { variables: opts.variables } : {}),
+            },
+        };
+    },
+    restApi(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "restApi",
+            config: {
+                url: opts.url,
+                method: opts.method,
+                ...(opts.body ? { body: opts.body } : {}),
+                ...(opts.headers ? { headers: opts.headers } : {}),
+            },
+        };
+    },
+    branch(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "branch",
+            config: { conditions: opts.conditions },
+        };
+    },
+    filter(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "filter",
+            config: { expression: opts.expression, inputVariable: opts.inputVariable },
+        };
+    },
+    loop(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "loop",
+            config: {
+                inputVariable: opts.inputVariable,
+                ...(opts.iterVar ? { iterVar: opts.iterVar } : {}),
+                runner: opts.runner,
+            },
+        };
+    },
+    customCode(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "customCode",
+            config: {
+                source: opts.source,
+                lang: opts.lang ?? "javascript",
+            },
+        };
+    },
+    balance(opts) {
+        return {
+            id: opts.id,
+            name: opts.name,
+            type: "balance",
+            config: {
+                address: opts.address,
+                chain: opts.chain,
+                ...(opts.includeSpam !== undefined ? { includeSpam: opts.includeSpam } : {}),
+                ...(opts.includeZeroBalances !== undefined ? { includeZeroBalances: opts.includeZeroBalances } : {}),
+                ...(opts.minUsdValueCents !== undefined ? { minUsdValueCents: opts.minUsdValueCents } : {}),
+            },
+        };
+    },
+});

package/dist/v4/builders/triggers.d.ts

@@ -0,0 +1,66 @@
+import type { v4 } from "@avaprotocol/types";
+/**
+ * Typed builders for the Trigger discriminated union. Output is a
+ * plain JSON object shaped like `v4.Trigger` (no class instances) so
+ * it round-trips cleanly across the REST boundary.
+ *
+ * Conventional usage:
+ *
+ *   import { Triggers } from "@avaprotocol/sdk-js";
+ *   const trigger = Triggers.cron({ name: "every5min", schedule: ["asterisk/5 * * * *"] });
+ *   const wf = await client.workflows.create({ trigger, nodes, ... });
+ *
+ * The builders ARE NOT classes — calling each returns a plain object
+ * the REST surface accepts. Keep the same shape on the wire whether
+ * SDK callers use the builder or hand-assemble the object.
+ */
+export declare const Triggers: Readonly<{
+    block(opts: {
+        name: string;
+        id?: string;
+        interval: number;
+        chainId?: number;
+    }): v4.Trigger;
+    cron(opts: {
+        name: string;
+        id?: string;
+        /** Crontab strings — multiple schedules OR together. */
+        schedule: string[];
+        timezone?: string;
+    }): v4.Trigger;
+    fixedTime(opts: {
+        name: string;
+        id?: string;
+        epochsMs: number[];
+    }): v4.Trigger;
+    manual(opts: {
+        name: string;
+        id?: string;
+        lang?: v4.Lang;
+        /** Payload returned in the trigger output when the workflow is triggered. */
+        data?: Record<string, unknown>;
+        /** Optional HTTP headers (for webhook-style testing). */
+        headers?: Record<string, string>;
+        /** Optional URL path params (for webhook-style testing). */
+        pathParams?: Record<string, string>;
+    }): v4.Trigger;
+    event(opts: {
+        name: string;
+        id?: string;
+        queries: Array<{
+            addresses?: string[];
+            /** Topic filters; empty string ("") matches any topic at that index. */
+            topics?: string[];
+            maxEventsPerBlock?: number;
+            conditions?: Array<{
+                fieldName: string;
+                operator: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains";
+                fieldType?: string;
+                value: Record<string, unknown>;
+            }>;
+        }>;
+        chainId?: number;
+        cooldownSeconds?: number;
+    }): v4.Trigger;
+}>;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/v4/builders/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/v4/builders/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;gBACP;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,EAAE,CAAC,OAAO;eAc/E;QACT,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,wDAAwD;QACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,EAAE,CAAC,OAAO;oBAYE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,EAAE,CAAC,OAAO;iBASjE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC;QACf,6EAA6E;QAC7E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,yDAAyD;QACzD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,4DAA4D;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,GAAG,EAAE,CAAC,OAAO;gBAcF;QACV,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,KAAK,CAAC;YACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;YACrB,wEAAwE;YACxE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;YAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,UAAU,CAAC,EAAE,KAAK,CAAC;gBACjB,SAAS,EAAE,MAAM,CAAC;gBAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,UAAU,CAAC;gBACjE,SAAS,CAAC,EAAE,MAAM,CAAC;gBACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aAChC,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,EAAE,CAAC,OAAO;EAYd,CAAC"}

package/dist/v4/builders/triggers.js

@@ -0,0 +1,74 @@
+/**
+ * Typed builders for the Trigger discriminated union. Output is a
+ * plain JSON object shaped like `v4.Trigger` (no class instances) so
+ * it round-trips cleanly across the REST boundary.
+ *
+ * Conventional usage:
+ *
+ *   import { Triggers } from "@avaprotocol/sdk-js";
+ *   const trigger = Triggers.cron({ name: "every5min", schedule: ["asterisk/5 * * * *"] });
+ *   const wf = await client.workflows.create({ trigger, nodes, ... });
+ *
+ * The builders ARE NOT classes — calling each returns a plain object
+ * the REST surface accepts. Keep the same shape on the wire whether
+ * SDK callers use the builder or hand-assemble the object.
+ */
+export const Triggers = Object.freeze({
+    block(opts) {
+        return {
+            type: "block",
+            name: opts.name,
+            ...(opts.id ? { id: opts.id } : {}),
+            // The OpenAPI Trigger schema is a discriminated union — the
+            // inline shape below carries the BlockTrigger's `config` slot
+            // alongside the discriminator. Both forms (`{type, config}` and
+            // the `BlockTrigger.type` enum) survive the wire-level merge
+            // oapi-codegen's serializer performs.
+            config: { interval: opts.interval, ...(opts.chainId ? { chainId: opts.chainId } : {}) },
+        };
+    },
+    cron(opts) {
+        return {
+            type: "cron",
+            name: opts.name,
+            ...(opts.id ? { id: opts.id } : {}),
+            config: {
+                schedules: opts.schedule,
+                ...(opts.timezone ? { timezone: opts.timezone } : {}),
+            },
+        };
+    },
+    fixedTime(opts) {
+        return {
+            type: "fixedTime",
+            name: opts.name,
+            ...(opts.id ? { id: opts.id } : {}),
+            config: { epochs: opts.epochsMs },
+        };
+    },
+    manual(opts) {
+        return {
+            type: "manual",
+            name: opts.name,
+            ...(opts.id ? { id: opts.id } : {}),
+            config: {
+                lang: opts.lang ?? "json",
+                ...(opts.data !== undefined ? { data: opts.data } : {}),
+                ...(opts.headers ? { headers: opts.headers } : {}),
+                ...(opts.pathParams ? { pathParams: opts.pathParams } : {}),
+            },
+        };
+    },
+    event(opts) {
+        return {
+            type: "event",
+            name: opts.name,
+            ...(opts.id ? { id: opts.id } : {}),
+            config: {
+                queries: opts.queries,
+                ...(opts.chainId ? { chainId: opts.chainId } : {}),
+                ...(opts.cooldownSeconds !== undefined ? { cooldownSeconds: opts.cooldownSeconds } : {}),
+            },
+        };
+    },
+});

package/dist/v4/chains.d.ts

@@ -0,0 +1,16 @@
+export declare const Chains: Readonly<{
+    EthereumMainnet: 1;
+    Sepolia: 11155111;
+    Holesky: 17000;
+    BaseMainnet: 8453;
+    BaseSepolia: 84532;
+    /**
+     * The chain the auth handler signs the canonical EIP-191 message
+     * against. Defaults to Sepolia — keep this synced with the
+     * aggregator's `smart_wallet.chain_id` setting (currently Sepolia
+     * in dev/staging, Ethereum mainnet in production).
+     */
+    EigenLayerAuth: 11155111;
+}>;
+export type ChainId = (typeof Chains)[keyof typeof Chains] | number;
+//# sourceMappingURL=chains.d.ts.map

package/dist/v4/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../src/v4/chains.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM;;;;;;IAMjB;;;;;OAKG;;EAEH,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC"}

package/dist/v4/chains.js

@@ -0,0 +1,23 @@
+// Chain ID constants for v4 callers. The aggregator's REST API accepts
+// any int64 chainId on chain-aware requests — these constants exist so
+// SDK callers don't sprinkle magic numbers and so the auth flow has a
+// single source of truth for which chain JWTs are minted against.
+//
+// `EigenLayerAuth` is the chain the aggregator's auth handler treats
+// as the canonical audience. It does NOT have to match the workflow's
+// target chain — the v4 auth flow is chain-agnostic. Keep this in
+// lockstep with the engine's smart-wallet config.
+export const Chains = Object.freeze({
+    EthereumMainnet: 1,
+    Sepolia: 11155111,
+    Holesky: 17000,
+    BaseMainnet: 8453,
+    BaseSepolia: 84532,
+    /**
+     * The chain the auth handler signs the canonical EIP-191 message
+     * against. Defaults to Sepolia — keep this synced with the
+     * aggregator's `smart_wallet.chain_id` setting (currently Sepolia
+     * in dev/staging, Ethereum mainnet in production).
+     */
+    EigenLayerAuth: 11155111,
+});

package/dist/v4/client.d.ts

@@ -0,0 +1,60 @@
+import { AuthResource } from "./resources/auth";
+import { ExecutionsResource } from "./resources/executions";
+import { HealthResource } from "./resources/health";
+import { NodesResource } from "./resources/nodes";
+import { OperatorsResource } from "./resources/operators";
+import { SecretsResource } from "./resources/secrets";
+import { TokensResource } from "./resources/tokens";
+import { TriggersResource } from "./resources/triggers";
+import { WalletsResource } from "./resources/wallets";
+import { WorkflowsResource } from "./resources/workflows";
+export interface ClientOptions {
+    /**
+     * Base URL of the REST API including the `/api/v1` prefix. Example:
+     * `https://gateway.avaprotocol.org/api/v1`. The SDK does not append
+     * `/api/v1` for you; partners running their own aggregator instance
+     * can point baseUrl elsewhere if their reverse proxy strips the prefix.
+     */
+    baseUrl: string;
+    /**
+     * Optional pre-minted JWT. Skip if you'll call
+     * `client.auth.exchange()` after construction.
+     */
+    token?: string;
+    /** Default request timeout in milliseconds. Defaults to 30s. */
+    defaultTimeoutMs?: number;
+    /** Override the fetch impl. Useful for tests and non-Node runtimes. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * v4 SDK entry point. Resource-grouped sub-clients (Stripe / OpenAI
+ * convention). Construct one Client per aggregator endpoint; all
+ * requests share the same transport (and therefore the same Bearer
+ * token + timeout + fetch impl).
+ *
+ * @example
+ *   import { Client } from "@avaprotocol/sdk-js";
+ *   const client = new Client({ baseUrl: process.env.AVS_REST_URL! });
+ *   await client.auth.exchangeWithKey(process.env.TEST_PRIVATE_KEY!);
+ *   const wf = await client.workflows.create({ ... });
+ *   await client.workflows.cancel(wf.id);
+ */
+export declare class Client {
+    readonly auth: AuthResource;
+    readonly executions: ExecutionsResource;
+    readonly health: HealthResource;
+    readonly nodes: NodesResource;
+    readonly operators: OperatorsResource;
+    readonly secrets: SecretsResource;
+    readonly tokens: TokensResource;
+    readonly triggers: TriggersResource;
+    readonly wallets: WalletsResource;
+    readonly workflows: WorkflowsResource;
+    private readonly transport;
+    constructor(opts: ClientOptions);
+    /** Replace the current Bearer token. */
+    setToken(token: string | undefined): void;
+    /** Current Bearer token. Returns undefined when anonymous. */
+    get token(): string | undefined;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/v4/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/v4/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,IAAI,EAAE,aAAa;IAqB/B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIzC,8DAA8D;IAC9D,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;CACF"}