@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2

package/build/src/clients/uniswap-sdk.d.ts

@@ -0,0 +1,4 @@
+export declare const Actions: typeof import("@uniswap/v4-sdk").Actions, V4Planner: typeof import("@uniswap/v4-sdk").V4Planner;
+export declare const CommandType: typeof import("@uniswap/universal-router-sdk").CommandType, RoutePlanner: typeof import("@uniswap/universal-router-sdk").RoutePlanner;
+export declare const ChainId: typeof import("@uniswap/sdk-core").ChainId;
+export type { SwapExactInSingle, SwapExactIn } from "@uniswap/v4-sdk";

package/build/src/clients/uniswap-sdk.js

@@ -0,0 +1,13 @@
+/**
+ * CJS re-exports for @uniswap/v4-sdk and @uniswap/universal-router-sdk.
+ * Uses createRequire because upstream ESM builds omit .js extensions on internal imports.
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const v4Sdk = require("@uniswap/v4-sdk");
+const universalRouterSdk = require("@uniswap/universal-router-sdk");
+const sdkCore = require("@uniswap/sdk-core");
+export const { Actions, V4Planner } = v4Sdk;
+export const { CommandType, RoutePlanner } = universalRouterSdk;
+export const { ChainId } = sdkCore;
+//# sourceMappingURL=uniswap-sdk.js.map

package/build/src/clients/uniswap-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-sdk.js","sourceRoot":"","sources":["../../../src/clients/uniswap-sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAqC,CAAC;AAC7E,MAAM,kBAAkB,GACtB,OAAO,CAAC,+BAA+B,CAAmD,CAAC;AAC7F,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAuC,CAAC;AAEnF,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAAC;AAChE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC"}

package/build/src/config/aave.d.ts

@@ -0,0 +1,17 @@
+/** Aave V3 on Celo mainnet — from bgd-labs/aave-address-book AaveV3Celo */
+export declare const AAVE_POOL: "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+export declare const AAVE_CHAIN_ID = 42220;
+/** Underlying and aToken addresses for one Aave V3 market on Celo. */
+export type AaveAsset = {
+    symbol: string;
+    underlying: `0x${string}`;
+    aToken: `0x${string}`;
+};
+export declare const AAVE_ASSETS: Record<string, AaveAsset>;
+export declare const AAVE_SUPPORTED_SYMBOLS: readonly ["USDT", "WETH", "USDm", "USDC", "CELO", "EURm"];
+/**
+ * Resolve an Aave V3 Celo asset by symbol or underlying/aToken address.
+ * @param token - Registry symbol or hex address
+ * @throws When the token is not listed in `AAVE_SUPPORTED_SYMBOLS`
+ */
+export declare function resolveAaveAsset(token: string): AaveAsset;

package/build/src/config/aave.js

@@ -0,0 +1,77 @@
+/**
+ * Aave V3 Celo mainnet pool addresses and supported asset registry.
+ */
+import { findKnownToken } from "./chains.js";
+const HEX_ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
+/** Aave V3 on Celo mainnet — from bgd-labs/aave-address-book AaveV3Celo */
+export const AAVE_POOL = "0x3E59A31363E2ad014dcbc521c4a0d5757d9f3402";
+export const AAVE_CHAIN_ID = 42220;
+export const AAVE_ASSETS = {
+    USDT: {
+        symbol: "USDT",
+        underlying: "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e",
+        aToken: "0xDeE98402A302e4D707fB9bf2bac66fAEEc31e8Df",
+    },
+    WETH: {
+        symbol: "WETH",
+        underlying: "0xD221812de1BD094f35587EE8E174B07B6167D9Af",
+        aToken: "0xf385280F36e009C157697D25E0B802EfaBfd789c",
+    },
+    USDm: {
+        symbol: "USDm",
+        underlying: "0x765DE816845861e75A25fCA122bb6898B8B1282a",
+        aToken: "0xBba98352628B0B0c4b40583F593fFCb630935a45",
+    },
+    USDC: {
+        symbol: "USDC",
+        underlying: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+        aToken: "0xFF8309b9e99bfd2D4021bc71a362aBD93dBd4785",
+    },
+    CELO: {
+        symbol: "CELO",
+        underlying: "0x471EcE3750Da237f93B8E339c536989b8978a438",
+        aToken: "0xC3e77dC389537Db1EEc7C33B95Cf3beECA71A209",
+    },
+    EURm: {
+        symbol: "EURm",
+        underlying: "0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73",
+        aToken: "0x34c02571094e08E935B8cf8dC10F1Ad6795f1f81",
+    },
+};
+export const AAVE_SUPPORTED_SYMBOLS = [
+    "USDT",
+    "WETH",
+    "USDm",
+    "USDC",
+    "CELO",
+    "EURm",
+];
+/**
+ * Resolve an Aave V3 Celo asset by symbol or underlying/aToken address.
+ * @param token - Registry symbol or hex address
+ * @throws When the token is not listed in `AAVE_SUPPORTED_SYMBOLS`
+ */
+export function resolveAaveAsset(token) {
+    const normalized = token.trim();
+    const known = findKnownToken(normalized);
+    if (known) {
+        const byKnownSymbol = AAVE_ASSETS[known.symbol];
+        if (byKnownSymbol) {
+            return byKnownSymbol;
+        }
+    }
+    if (HEX_ADDRESS_RE.test(normalized)) {
+        const lower = normalized.toLowerCase();
+        const byAddress = Object.values(AAVE_ASSETS).find((asset) => asset.underlying.toLowerCase() === lower ||
+            asset.aToken.toLowerCase() === lower);
+        if (byAddress) {
+            return byAddress;
+        }
+    }
+    const bySymbol = Object.values(AAVE_ASSETS).find((asset) => asset.symbol.toLowerCase() === normalized.toLowerCase());
+    if (bySymbol) {
+        return bySymbol;
+    }
+    throw new Error(`Token "${token}" is not supported on Aave V3 Celo. Supported: ${AAVE_SUPPORTED_SYMBOLS.join(", ")}.`);
+}
+//# sourceMappingURL=aave.js.map

package/build/src/config/aave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave.js","sourceRoot":"","sources":["../../../src/config/aave.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAE7C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,4CAAqD,CAAC;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AASnC,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,4CAA4C;QACxD,MAAM,EAAE,4CAA4C;KACrD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAC/C,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,KAAK;YACxC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,CACvC,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAC9C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CACnE,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,kDAAkD,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtG,CAAC;AACJ,CAAC"}

package/build/src/config/celina-tag.d.ts

@@ -0,0 +1,55 @@
+import { ERC_8021_MARKER } from "@celo/attribution-tags";
+/** Legacy UTF-8 marker hex(`"CELINA"`) used inside the dual attribution suffix — not the full on-chain tag by itself. Full wire format is legacy `CELINA|…` plus an ERC-8021 Schema 0 suffix; see {@link appendCelinaCalldataTag}. */
+export declare const CELINA_DATA_SUFFIX: `0x${string}`;
+export { ERC_8021_MARKER };
+/** Normalize custom attribution tags while preserving first-seen order. */
+export declare function normalizeAttributionTags(tags?: string[]): string[];
+/** Build deterministic attribution tag string that always starts with `CELINA`. */
+export declare function buildCelinaAttributionTag(tags?: string[]): string;
+/** Map client attribution tags to ERC-8021 Schema 0 codes (lowercase `[a-z0-9_]` only). */
+export declare function toErc8021AttributionCodes(attributionTags?: string[]): string[];
+/** Build ERC-8021 Schema 0 suffix hex for the given attribution tags. */
+export declare function buildErc8021AttributionSuffix(attributionTags?: string[]): `0x${string}`;
+/**
+ * Truncate calldata to end at an embedded ERC-8021 Schema 0 suffix when tip parse fails.
+ * Tip-of-calldata tags are returned unchanged.
+ */
+export declare function attributionDecodeWindow(data: `0x${string}`): `0x${string}`;
+/** Strip a trailing ERC-8021 Schema 0/2 suffix when present. */
+export declare function stripErc8021SuffixIfPresent(data: `0x${string}`): `0x${string}`;
+/** Parse legacy UTF-8 `CELINA|TAG1|…` suffix from calldata (ignores trailing ERC-8021). */
+export declare function parseCelinaLegacyAttributionSuffix(data: `0x${string}`): string[] | null;
+export type AttributionVerificationResult = {
+    legacyTags: string[] | null;
+    erc8021: {
+        codes: string[];
+        schemaId: number;
+    } | null;
+    matched: boolean;
+};
+/** Verification result plus a unified custom/app `tags` list (excludes platform CELINA/celina). */
+export type AttributionCheckResult = AttributionVerificationResult & {
+    tags: string[];
+};
+/** Merge legacy + ERC-8021 codes into custom tags (skips CELINA/celina, dedupes). */
+export declare function collectAttributionTags(legacyTags: string[] | null, erc8021Codes: string[] | null): string[];
+/** Decode legacy and ERC-8021 attribution from calldata; optionally check for a tag. */
+export declare function verifyAttributionInCalldata(data: `0x${string}`, tag?: string): AttributionVerificationResult;
+/**
+ * Decode attribution from calldata with a unified custom `tags` list.
+ * Prefer this for “what tags are on this tx?”; use {@link verifyAttributionInCalldata} for the raw layers only.
+ */
+export declare function checkAttributionInCalldata(data: `0x${string}`, tag?: string): AttributionCheckResult;
+/**
+ * Append dual Celina attribution suffixes to calldata (legacy UTF-8 + ERC-8021).
+ *
+ * Used by `prepare*` when `createCelinaClient({ attributionTags })` is set, and by
+ * `createAAClient({ attributionTags }).sendPreparedFlow` when AA tags are set.
+ *
+ * @param data - Original transaction calldata.
+ * @param attributionTags - Optional custom tags (same list semantics on Celina or AA client).
+ *   Legacy layer: `CELINA|TAG1|TAG2` (app tags uppercase, `celo_<12 hex>` lowercase).
+ *   ERC-8021 layer: `toDataSuffix(["celina", ...])` with lowercase codes.
+ *   Example: `["goclaim"]` → legacy `CELINA|GOCLAIM` + codes `celina`, `goclaim` (not bare UTF-8 `GOCLAIM`).
+ */
+export declare function appendCelinaCalldataTag(data: `0x${string}`, attributionTags?: string[]): `0x${string}`;

package/build/src/config/celina-tag.js

@@ -0,0 +1,234 @@
+import { ERC_8021_MARKER, fromDataSuffix, toDataSuffix, } from "@celo/attribution-tags";
+import { concat, hexToString, stringToHex } from "viem";
+/** Legacy UTF-8 marker hex(`"CELINA"`) used inside the dual attribution suffix — not the full on-chain tag by itself. Full wire format is legacy `CELINA|…` plus an ERC-8021 Schema 0 suffix; see {@link appendCelinaCalldataTag}. */
+export const CELINA_DATA_SUFFIX = stringToHex("CELINA");
+export { ERC_8021_MARKER };
+/** Celo Builders on-chain attribution tag: `celo_` + 12 hex chars (lowercase). */
+const CELO_BUILDERS_TAG = /^celo_[0-9a-f]{12}$/i;
+const CELINA_PLATFORM_ERC8021_CODE = "celina";
+function normalizeAttributionTag(tag) {
+    const trimmed = tag.trim();
+    if (CELO_BUILDERS_TAG.test(trimmed)) {
+        return trimmed.toLowerCase();
+    }
+    return trimmed.toUpperCase();
+}
+/** Normalize custom attribution tags while preserving first-seen order. */
+export function normalizeAttributionTags(tags) {
+    if (!tags?.length)
+        return [];
+    const deduped = new Set();
+    for (const tag of tags) {
+        const normalized = normalizeAttributionTag(tag);
+        if (!normalized || normalized === "CELINA" || deduped.has(normalized))
+            continue;
+        deduped.add(normalized);
+    }
+    return [...deduped];
+}
+/** Build deterministic attribution tag string that always starts with `CELINA`. */
+export function buildCelinaAttributionTag(tags) {
+    const normalized = normalizeAttributionTags(tags);
+    return normalized.length ? `CELINA|${normalized.join("|")}` : "CELINA";
+}
+/** Map client attribution tags to ERC-8021 Schema 0 codes (lowercase `[a-z0-9_]` only). */
+export function toErc8021AttributionCodes(attributionTags) {
+    const codes = [CELINA_PLATFORM_ERC8021_CODE];
+    for (const tag of normalizeAttributionTags(attributionTags)) {
+        codes.push(tag.toLowerCase());
+    }
+    return [...new Set(codes)];
+}
+/** Build ERC-8021 Schema 0 suffix hex for the given attribution tags. */
+export function buildErc8021AttributionSuffix(attributionTags) {
+    const codes = toErc8021AttributionCodes(attributionTags);
+    return codes.length === 1
+        ? toDataSuffix(codes[0])
+        : toDataSuffix(codes);
+}
+function buildLegacyAttributionSuffixHex(attributionTags) {
+    return stringToHex(buildCelinaAttributionTag(attributionTags));
+}
+function sameCodeSets(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const sortedA = [...a].map((c) => c.toLowerCase()).sort();
+    const sortedB = [...b].map((c) => c.toLowerCase()).sort();
+    return sortedA.every((code, i) => code === sortedB[i]);
+}
+/**
+ * Locate a valid ERC-8021 Schema 0 suffix even when trailing bytes follow the marker
+ * (AA/UserOp packing). Prefers the last valid occurrence.
+ */
+function findErc8021Schema0Suffix(data) {
+    const hex = data.slice(2).toLowerCase();
+    const markerHex = ERC_8021_MARKER.slice(2).toLowerCase();
+    if (hex.length < markerHex.length + 4)
+        return null;
+    let searchEnd = hex.length;
+    while (searchEnd >= markerHex.length) {
+        const idx = hex.lastIndexOf(markerHex, searchEnd - 1);
+        if (idx === -1)
+            return null;
+        const markerEnd = idx + markerHex.length;
+        const schemaPos = idx - 2;
+        const lengthPos = schemaPos - 2;
+        if (lengthPos < 0) {
+            searchEnd = idx;
+            continue;
+        }
+        const schemaId = Number.parseInt(hex.slice(schemaPos, idx), 16);
+        const lengthByte = Number.parseInt(hex.slice(lengthPos, schemaPos), 16);
+        const suffixStart = lengthPos - lengthByte * 2;
+        if (schemaId !== 0 ||
+            !Number.isFinite(lengthByte) ||
+            lengthByte < 0 ||
+            suffixStart < 0) {
+            searchEnd = idx;
+            continue;
+        }
+        const window = `0x${hex.slice(0, markerEnd)}`;
+        const decoded = fromDataSuffix(window);
+        if (decoded && decoded.schemaId === 0) {
+            return {
+                suffixStart,
+                markerEnd,
+                decoded: { codes: [...decoded.codes], schemaId: decoded.schemaId },
+            };
+        }
+        searchEnd = idx;
+    }
+    return null;
+}
+/**
+ * Truncate calldata to end at an embedded ERC-8021 Schema 0 suffix when tip parse fails.
+ * Tip-of-calldata tags are returned unchanged.
+ */
+export function attributionDecodeWindow(data) {
+    if (!data || data === "0x")
+        return data;
+    if (fromDataSuffix(data))
+        return data;
+    const found = findErc8021Schema0Suffix(data);
+    if (!found)
+        return data;
+    return `0x${data.slice(2).slice(0, found.markerEnd)}`;
+}
+/** Strip a trailing ERC-8021 Schema 0/2 suffix when present. */
+export function stripErc8021SuffixIfPresent(data) {
+    if (!fromDataSuffix(data))
+        return data;
+    const hex = data.slice(2);
+    const markerHex = ERC_8021_MARKER.slice(2).toLowerCase();
+    const markerByteLen = markerHex.length / 2;
+    if (hex.length < markerByteLen * 2)
+        return data;
+    if (hex.slice(-markerByteLen * 2).toLowerCase() !== markerHex)
+        return data;
+    const schemaPos = hex.length - markerByteLen * 2 - 2;
+    const lengthFieldHex = hex.slice(schemaPos - 2, schemaPos);
+    const lengthByte = Number.parseInt(lengthFieldHex, 16);
+    const suffixStart = schemaPos - 2 - lengthByte * 2;
+    if (suffixStart < 0)
+        return data;
+    return `0x${hex.slice(0, suffixStart)}`;
+}
+/** Printable legacy segments: `CELINA` or `CELINA|TAG1|…` (stops before binary / ERC-8021 ASCII). */
+const LEGACY_ATTRIBUTION_TEXT = /^CELINA(?:\|[A-Za-z0-9_]+)*/;
+/** Parse legacy UTF-8 `CELINA|TAG1|…` suffix from calldata (ignores trailing ERC-8021). */
+export function parseCelinaLegacyAttributionSuffix(data) {
+    const body = stripErc8021SuffixIfPresent(data);
+    const celinaMarker = stringToHex("CELINA").slice(2).toLowerCase();
+    const lower = body.slice(2).toLowerCase();
+    const idx = lower.lastIndexOf(celinaMarker);
+    if (idx === -1)
+        return null;
+    try {
+        const suffixHex = `0x${body.slice(2).slice(idx)}`;
+        const text = hexToString(suffixHex);
+        if (!text.startsWith("CELINA"))
+            return null;
+        const printable = text.match(LEGACY_ATTRIBUTION_TEXT)?.[0];
+        if (!printable)
+            return null;
+        return printable.split("|");
+    }
+    catch {
+        return null;
+    }
+}
+function tagMatchesVerification(tag, legacyTags, erc8021Codes) {
+    const normalized = normalizeAttributionTag(tag);
+    const legacyHit = legacyTags?.some((legacyTag) => normalizeAttributionTag(legacyTag) === normalized) ??
+        false;
+    const ercHit = erc8021Codes?.some((code) => code.toLowerCase() === normalized.toLowerCase()) ??
+        false;
+    return legacyHit || ercHit;
+}
+/** Merge legacy + ERC-8021 codes into custom tags (skips CELINA/celina, dedupes). */
+export function collectAttributionTags(legacyTags, erc8021Codes) {
+    return normalizeAttributionTags([
+        ...(legacyTags ?? []),
+        ...(erc8021Codes ?? []),
+    ]);
+}
+/** Decode legacy and ERC-8021 attribution from calldata; optionally check for a tag. */
+export function verifyAttributionInCalldata(data, tag) {
+    const window = attributionDecodeWindow(data);
+    const legacyTags = parseCelinaLegacyAttributionSuffix(window);
+    const erc8021 = fromDataSuffix(window);
+    const matched = tag
+        ? tagMatchesVerification(tag, legacyTags, erc8021?.codes ?? null)
+        : Boolean(legacyTags?.length || erc8021?.codes.length);
+    return {
+        legacyTags,
+        erc8021: erc8021
+            ? { codes: [...erc8021.codes], schemaId: erc8021.schemaId }
+            : null,
+        matched,
+    };
+}
+/**
+ * Decode attribution from calldata with a unified custom `tags` list.
+ * Prefer this for “what tags are on this tx?”; use {@link verifyAttributionInCalldata} for the raw layers only.
+ */
+export function checkAttributionInCalldata(data, tag) {
+    const verified = verifyAttributionInCalldata(data, tag);
+    return {
+        ...verified,
+        tags: collectAttributionTags(verified.legacyTags, verified.erc8021?.codes ?? null),
+    };
+}
+/**
+ * Append dual Celina attribution suffixes to calldata (legacy UTF-8 + ERC-8021).
+ *
+ * Used by `prepare*` when `createCelinaClient({ attributionTags })` is set, and by
+ * `createAAClient({ attributionTags }).sendPreparedFlow` when AA tags are set.
+ *
+ * @param data - Original transaction calldata.
+ * @param attributionTags - Optional custom tags (same list semantics on Celina or AA client).
+ *   Legacy layer: `CELINA|TAG1|TAG2` (app tags uppercase, `celo_<12 hex>` lowercase).
+ *   ERC-8021 layer: `toDataSuffix(["celina", ...])` with lowercase codes.
+ *   Example: `["goclaim"]` → legacy `CELINA|GOCLAIM` + codes `celina`, `goclaim` (not bare UTF-8 `GOCLAIM`).
+ */
+export function appendCelinaCalldataTag(data, attributionTags) {
+    if (!data || data === "0x")
+        return data;
+    const legacyHex = buildLegacyAttributionSuffixHex(attributionTags);
+    const legacySuffix = legacyHex.slice(2);
+    const erc8021Hex = buildErc8021AttributionSuffix(attributionTags);
+    const expectedCodes = toErc8021AttributionCodes(attributionTags);
+    const fullDualSuffix = `${legacySuffix}${erc8021Hex.slice(2)}`.toLowerCase();
+    if (data.toLowerCase().endsWith(fullDualSuffix))
+        return data;
+    let result = stripErc8021SuffixIfPresent(data);
+    if (!result.toLowerCase().endsWith(legacySuffix.toLowerCase())) {
+        result = concat([result, legacyHex]);
+    }
+    const decoded = fromDataSuffix(result);
+    if (!decoded || !sameCodeSets(decoded.codes, expectedCodes)) {
+        result = concat([result, erc8021Hex]);
+    }
+    return result;
+}
+//# sourceMappingURL=celina-tag.js.map

package/build/src/config/celina-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celina-tag.js","sourceRoot":"","sources":["../../../src/config/celina-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAExD,sOAAsO;AACtO,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,kFAAkF;AAClF,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEjD,MAAM,4BAA4B,GAAG,QAAQ,CAAC;AAE9C,SAAS,uBAAuB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB,CAAC,IAAe;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAChF,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CAAC,IAAe;IACvD,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzE,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yBAAyB,CAAC,eAA0B;IAClE,MAAM,KAAK,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,wBAAwB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,6BAA6B,CAC3C,eAA0B;IAE1B,MAAM,KAAK,GAAG,yBAAyB,CAAC,eAAe,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,+BAA+B,CACtC,eAA0B;IAE1B,OAAO,WAAW,CAAC,yBAAyB,CAAC,eAAe,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,YAAY,CAAC,CAAoB,EAAE,CAAoB;IAC9D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAUD;;;GAGG;AACH,SAAS,wBAAwB,CAC/B,IAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,IAAI,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;IAC3B,OAAO,SAAS,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACtD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5B,MAAM,SAAS,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;QACzC,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC;QAC1B,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,SAAS,GAAG,GAAG,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,CAAC,CAAC;QAC/C,IACE,QAAQ,KAAK,CAAC;YACd,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,UAAU,GAAG,CAAC;YACd,WAAW,GAAG,CAAC,EACf,CAAC;YACD,SAAS,GAAG,GAAG,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAmB,CAAC;QAC/D,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,WAAW;gBACX,SAAS;gBACT,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;aACnE,CAAC;QACJ,CAAC;QAED,SAAS,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAmB;IACzD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,EAAmB,CAAC;AACzE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,2BAA2B,CACzC,IAAmB;IAEnB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE3E,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,GAAG,aAAa,GAAG,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,SAAS,GAAG,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC;IACnD,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,EAAmB,CAAC;AAC3D,CAAC;AAED,qGAAqG;AACrG,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAE9D,2FAA2F;AAC3F,MAAM,UAAU,kCAAkC,CAChD,IAAmB;IAEnB,MAAM,IAAI,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAmB,CAAC;QACnE,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAaD,SAAS,sBAAsB,CAC7B,GAAW,EACX,UAA2B,EAC3B,YAA6B;IAE7B,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,SAAS,GACb,UAAU,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,uBAAuB,CAAC,SAAS,CAAC,KAAK,UAAU,CAAC;QAClF,KAAK,CAAC;IACR,MAAM,MAAM,GACV,YAAY,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC;QAC7E,KAAK,CAAC;IACR,OAAO,SAAS,IAAI,MAAM,CAAC;AAC7B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CACpC,UAA2B,EAC3B,YAA6B;IAE7B,OAAO,wBAAwB,CAAC;QAC9B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACrB,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;KACxB,CAAC,CAAC;AACL,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,2BAA2B,CACzC,IAAmB,EACnB,GAAY;IAEZ,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG;QACjB,CAAC,CAAC,sBAAsB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;QACjE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzD,OAAO;QACL,UAAU;QACV,OAAO,EAAE,OAAO;YACd,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;YAC3D,CAAC,CAAC,IAAI;QACR,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAmB,EACnB,GAAY;IAEZ,MAAM,QAAQ,GAAG,2BAA2B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE,sBAAsB,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;KACnF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAmB,EACnB,eAA0B;IAE1B,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,SAAS,GAAG,+BAA+B,CAAC,eAAe,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,6BAA6B,CAAC,eAAe,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,yBAAyB,CAAC,eAAe,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,GAAG,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,IAAI,MAAM,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/src/config/celo-core-contracts.d.ts

@@ -0,0 +1,8 @@
+/** Celo mainnet core contract addresses (Election, Governance, etc.). */
+export declare const CELO_CORE_CONTRACTS: {
+    readonly governance: "0xD533Ca259b330c7A88f74E000a3FaEa2d63B7972";
+    readonly election: "0x8D6677192144292870907E3Fa8A5527fE55A7ff6";
+    readonly validators: "0xaEb865bCa93DdC8F47b8e29F40C5399cE34d0C58";
+    readonly accounts: "0x7d21685C17607338b313a7174bAb6620baD0aaB7";
+    readonly lockedGold: "0x6cC083Aed9e3ebe302A6336dBC7c921C9f03349E";
+};

package/build/src/config/celo-core-contracts.js

@@ -0,0 +1,9 @@
+/** Celo mainnet core contract addresses (Election, Governance, etc.). */
+export const CELO_CORE_CONTRACTS = {
+    governance: "0xD533Ca259b330c7A88f74E000a3FaEa2d63B7972",
+    election: "0x8D6677192144292870907E3Fa8A5527fE55A7ff6",
+    validators: "0xaEb865bCa93DdC8F47b8e29F40C5399cE34d0C58",
+    accounts: "0x7d21685C17607338b313a7174bAb6620baD0aaB7",
+    lockedGold: "0x6cC083Aed9e3ebe302A6336dBC7c921C9f03349E",
+};
+//# sourceMappingURL=celo-core-contracts.js.map

package/build/src/config/celo-core-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celo-core-contracts.js","sourceRoot":"","sources":["../../../src/config/celo-core-contracts.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,UAAU,EAAE,4CAA4C;IACxD,QAAQ,EAAE,4CAA4C;IACtD,UAAU,EAAE,4CAA4C;CAChD,CAAC"}