@reptilianhq/launch-on-block-sdk 0.4.0

package/dist/receipts.d.ts

@@ -0,0 +1,84 @@
+import { type Address, type Hex } from "viem";
+export interface ReceiptLog {
+    address: Address;
+    data: Hex;
+    topics: readonly Hex[];
+}
+export interface ReceiptLike {
+    status: "success" | "reverted" | 0 | 1 | "0x0" | "0x1";
+    transactionHash?: Hex;
+    logs: readonly ReceiptLog[];
+}
+export interface LaunchCreatedResult {
+    token: Address;
+    creator: Address;
+    creatorBps: number;
+    curveFeeBps: number;
+    payoutWallet: Address;
+    metadataURI: string;
+}
+export interface CurveSelectedResult {
+    token: Address;
+    curveId: number;
+    implementation: Address;
+    quoteTarget: bigint;
+}
+export interface LaunchCreationResult {
+    launch: LaunchCreatedResult;
+    curve: CurveSelectedResult;
+}
+export interface BuyResult {
+    token: Address;
+    buyer: Address;
+    amountIn: bigint;
+    tokensOut: bigint;
+}
+export interface SellResult {
+    token: Address;
+    seller: Address;
+    tokensIn: bigint;
+    amountOut: bigint;
+}
+export interface GraduatedResult {
+    token: Address;
+    pool: Address;
+    totalRaised: bigint;
+    creatorCut: bigint;
+    protocolCut: bigint;
+    poolQuote: bigint;
+    poolTokens: bigint;
+    burnedTokens: bigint;
+}
+export interface RouterSwapResult {
+    sender: Address;
+    pool: Address;
+    amountIn: bigint;
+    amountOut: bigint;
+    to: Address;
+}
+export interface FeesCollectedResult {
+    pair: Address;
+    caller: Address;
+    amount0: bigint;
+    amount1: bigint;
+    protocolAmount0: bigint;
+    protocolAmount1: bigint;
+    creatorAmount0: bigint;
+    creatorAmount1: bigint;
+}
+export declare function assertSuccessfulReceipt(receipt: ReceiptLike): void;
+export declare function verifyLaunchCreatedReceipt(receipt: ReceiptLike, launchpad: Address, expected?: Partial<LaunchCreatedResult>): LaunchCreatedResult;
+export declare function verifyCurveSelectedReceipt(receipt: ReceiptLike, launchpad: Address, expected?: Partial<CurveSelectedResult>): CurveSelectedResult;
+/** Requires both creation events and proves that they describe the same launch token. */
+export declare function verifyLaunchCreationReceipt(receipt: ReceiptLike, launchpad: Address, expected?: {
+    launch?: Partial<LaunchCreatedResult>;
+    curve?: Partial<CurveSelectedResult>;
+}): LaunchCreationResult;
+export declare function verifyBuyReceipt(receipt: ReceiptLike, launchpad: Address, expected?: Partial<Pick<BuyResult, "token" | "buyer" | "amountIn">> & {
+    minTokensOut?: bigint;
+}): BuyResult;
+export declare function verifySellReceipt(receipt: ReceiptLike, launchpad: Address, expected?: Partial<Pick<SellResult, "token" | "seller">>): SellResult;
+export declare function verifyGraduatedReceipt(receipt: ReceiptLike, launchpad: Address, expected?: Partial<Pick<GraduatedResult, "token" | "pool">>): GraduatedResult;
+export declare function verifyRouterSwapReceipt(receipt: ReceiptLike, router: Address, expected?: Partial<Pick<RouterSwapResult, "sender" | "pool" | "to">>): RouterSwapResult;
+export declare function verifyFeesCollectedReceipt(receipt: ReceiptLike, feeController: Address, expected?: Partial<Pick<FeesCollectedResult, "pair" | "caller">>): FeesCollectedResult;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAIxE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;IACvD,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CASlE;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC1C,mBAAmB,CAIrB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC1C,mBAAmB,CAIrB;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE;IACR,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC,GACL,oBAAoB,CAWtB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAClG,SAAS,CAYX;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAM,GAC3D,UAAU,CAIZ;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,MAAM,CAAC,CAAM,GAC9D,eAAe,CAIjB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,OAAO,EACf,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC,CAAM,GACvE,gBAAgB,CAIlB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,OAAO,EACtB,QAAQ,GAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAM,GACnE,mBAAmB,CAIrB"}

package/dist/receipts.js

@@ -0,0 +1,104 @@
+import { decodeEventLog } from "viem";
+import { feeControllerAbi, launchpadAbi, routerAbi } from "./generated/abis.js";
+import { SdkError } from "./errors.js";
+export function assertSuccessfulReceipt(receipt) {
+    if (receipt.status !== "success" && receipt.status !== 1 && receipt.status !== "0x1") {
+        const suffix = receipt.transactionHash ? ` ${receipt.transactionHash}` : "";
+        throw new SdkError("RECEIPT_REVERTED", `Transaction${suffix} reverted`, {
+            path: "status",
+            expected: "success",
+            actual: String(receipt.status),
+        });
+    }
+}
+export function verifyLaunchCreatedReceipt(receipt, launchpad, expected = {}) {
+    const result = requireEvent(receipt, launchpad, launchpadAbi, "LaunchCreated");
+    assertExpected(result, expected, new Set(["token", "creator", "payoutWallet"]));
+    return result;
+}
+export function verifyCurveSelectedReceipt(receipt, launchpad, expected = {}) {
+    const result = requireEvent(receipt, launchpad, launchpadAbi, "CurveSelected");
+    assertExpected(result, expected, new Set(["token", "implementation"]));
+    return result;
+}
+/** Requires both creation events and proves that they describe the same launch token. */
+export function verifyLaunchCreationReceipt(receipt, launchpad, expected = {}) {
+    const launch = verifyLaunchCreatedReceipt(receipt, launchpad, expected.launch);
+    const curve = verifyCurveSelectedReceipt(receipt, launchpad, expected.curve);
+    if (!sameAddress(launch.token, curve.token)) {
+        throw new SdkError("RECEIPT_FIELD_MISMATCH", `Creation events disagree on token: LaunchCreated emitted ${launch.token}, CurveSelected emitted ${curve.token}`, { path: "curve.token", expected: launch.token, actual: curve.token });
+    }
+    return { launch, curve };
+}
+export function verifyBuyReceipt(receipt, launchpad, expected = {}) {
+    const result = requireEvent(receipt, launchpad, launchpadAbi, "Buy");
+    const { minTokensOut, ...exact } = expected;
+    assertExpected(result, exact, new Set(["token", "buyer"]));
+    if (minTokensOut !== undefined && result.tokensOut < minTokensOut) {
+        throw new SdkError("OUTPUT_BELOW_MINIMUM", `Receipt tokensOut is below the protected minimum: expected at least ${minTokensOut}, got ${result.tokensOut}`, { path: "tokensOut", expected: `>= ${minTokensOut}`, actual: String(result.tokensOut) });
+    }
+    return result;
+}
+export function verifySellReceipt(receipt, launchpad, expected = {}) {
+    const result = requireEvent(receipt, launchpad, launchpadAbi, "Sell");
+    assertExpected(result, expected, new Set(["token", "seller"]));
+    return result;
+}
+export function verifyGraduatedReceipt(receipt, launchpad, expected = {}) {
+    const result = requireEvent(receipt, launchpad, launchpadAbi, "Graduated");
+    assertExpected(result, expected, new Set(["token", "pool"]));
+    return result;
+}
+export function verifyRouterSwapReceipt(receipt, router, expected = {}) {
+    const result = requireEvent(receipt, router, routerAbi, "Swap");
+    assertExpected(result, expected, new Set(["sender", "pool", "to"]));
+    return result;
+}
+export function verifyFeesCollectedReceipt(receipt, feeController, expected = {}) {
+    const result = requireEvent(receipt, feeController, feeControllerAbi, "FeesCollected");
+    assertExpected(result, expected, new Set(["pair", "caller"]));
+    return result;
+}
+function requireEvent(receipt, emitter, abi, eventName) {
+    assertSuccessfulReceipt(receipt);
+    for (const log of receipt.logs) {
+        if (!sameAddress(log.address, emitter))
+            continue;
+        try {
+            const decoded = decodeEventLog({
+                abi,
+                eventName,
+                data: log.data,
+                topics: log.topics,
+                strict: true,
+            });
+            if (decoded.eventName !== eventName)
+                continue;
+            return decoded.args;
+        }
+        catch {
+            // An expected emitter can produce several unrelated events in one receipt.
+        }
+    }
+    const suffix = receipt.transactionHash ? ` in ${receipt.transactionHash}` : "";
+    throw new SdkError("EVENT_NOT_FOUND", `Expected ${eventName} event from ${emitter}${suffix}`, {
+        path: "logs",
+        expected: `${eventName} from ${emitter}`,
+        actual: "no matching log",
+    });
+}
+function assertExpected(actual, expected, addressFields) {
+    for (const [key, expectedValue] of Object.entries(expected)) {
+        const actualValue = actual[key];
+        const matches = addressFields.has(key) && typeof actualValue === "string" && typeof expectedValue === "string"
+            ? sameAddress(actualValue, expectedValue)
+            : actualValue === expectedValue;
+        if (!matches) {
+            throw new SdkError("RECEIPT_FIELD_MISMATCH", `Receipt ${key} mismatch: expected ${String(expectedValue)}, got ${String(actualValue)}`, { path: key, expected: String(expectedValue), actual: String(actualValue) });
+        }
+    }
+}
+function sameAddress(left, right) {
+    return left.toLowerCase() === right.toLowerCase();
+}
+//# sourceMappingURL=receipts.js.map

package/dist/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../src/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoC,MAAM,MAAM,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+EvC,MAAM,UAAU,uBAAuB,CAAC,OAAoB;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACrF,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,cAAc,MAAM,WAAW,EAAE;YACtE,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,SAAS;YACnB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAoB,EACpB,SAAkB,EAClB,WAAyC,EAAE;IAE3C,MAAM,MAAM,GAAG,YAAY,CAAsB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACpG,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAoB,EACpB,SAAkB,EAClB,WAAyC,EAAE;IAE3C,MAAM,MAAM,GAAG,YAAY,CAAsB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACpG,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,2BAA2B,CACzC,OAAoB,EACpB,SAAkB,EAClB,WAGI,EAAE;IAEN,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7E,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,QAAQ,CAChB,wBAAwB,EACxB,4DAA4D,MAAM,CAAC,KAAK,2BAA2B,KAAK,CAAC,KAAK,EAAE,EAChH,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAoB,EACpB,SAAkB,EAClB,WAAiG,EAAE;IAEnG,MAAM,MAAM,GAAG,YAAY,CAAY,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAChF,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;IAC5C,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAClE,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,uEAAuE,YAAY,SAAS,MAAM,CAAC,SAAS,EAAE,EAC9G,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,SAAkB,EAClB,WAA0D,EAAE;IAE5D,MAAM,MAAM,GAAG,YAAY,CAAa,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAClF,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAoB,EACpB,SAAkB,EAClB,WAA6D,EAAE;IAE/D,MAAM,MAAM,GAAG,YAAY,CAAkB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAC5F,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAoB,EACpB,MAAe,EACf,WAAsE,EAAE;IAExE,MAAM,MAAM,GAAG,YAAY,CAAmB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAClF,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAoB,EACpB,aAAsB,EACtB,WAAkE,EAAE;IAEpE,MAAM,MAAM,GAAG,YAAY,CAAsB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;IAC5G,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CACnB,OAAoB,EACpB,OAAgB,EAChB,GAAQ,EACR,SAAiB;IAEjB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,SAAS;QACjD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,cAAc,CAAC;gBAC7B,GAAG;gBACH,SAAS;gBACT,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAyB;gBACrC,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;gBAAE,SAAS;YAC9C,OAAO,OAAO,CAAC,IAAS,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,YAAY,SAAS,eAAe,OAAO,GAAG,MAAM,EAAE,EAAE;QAC5F,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,GAAG,SAAS,SAAS,OAAO,EAAE;QACxC,MAAM,EAAE,iBAAiB;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAmB,MAAS,EAAE,QAAoB,EAAE,aAAkC;IAC3G,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,GAAc,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,aAAa,KAAK,QAAQ;YAC5G,CAAC,CAAC,WAAW,CAAC,WAAsB,EAAE,aAAwB,CAAC;YAC/D,CAAC,CAAC,WAAW,KAAK,aAAa,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAChB,wBAAwB,EACxB,WAAW,GAAG,uBAAuB,MAAM,CAAC,aAAa,CAAC,SAAS,MAAM,CAAC,WAAW,CAAC,EAAE,EACxF,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,KAAc;IAChD,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;AACpD,CAAC"}

package/dist/transactions.d.ts

@@ -0,0 +1,115 @@
+import { type Address, type Hex } from "viem";
+export interface TransactionRequest {
+    to: Address;
+    data: Hex;
+    value: bigint;
+}
+/** JSON-RPC wallet shape used by `eth_sendTransaction`. */
+export interface RpcTransactionRequest {
+    to: Address;
+    data: Hex;
+    value: Hex;
+    gas: Hex;
+}
+/** Transaction fields required to prove that a mined transaction matches reviewed calldata. */
+export interface ConfirmedTransactionLike {
+    from: Address;
+    to: Address | null;
+    value: bigint;
+    input: Hex;
+}
+export interface CreateLaunchParameters {
+    name: string;
+    symbol: string;
+    creatorBps: number;
+    curveFeeBps: number;
+    payoutWallet: Address;
+    metadataUri: string;
+    /** Omit to use the on-chain DEFAULT_CURVE_ID. */
+    curveId?: number;
+    salt?: Hex;
+}
+export declare function buildCreateLaunchTransaction(launchpad: Address, parameters: CreateLaunchParameters): TransactionRequest;
+export declare function buildCurveBuyTransaction(launchpad: Address, parameters: {
+    token: Address;
+    minTokensOut: bigint;
+    value: bigint;
+}): TransactionRequest;
+export declare function buildCurveSellTransaction(launchpad: Address, parameters: {
+    token: Address;
+    tokensIn: bigint;
+    minAmountOut: bigint;
+}): TransactionRequest;
+export declare function buildGraduateTransaction(launchpad: Address, token: Address): TransactionRequest;
+export declare function buildClaimTransaction(launchpad: Address, token?: Address): TransactionRequest;
+export declare function buildApproveTransaction(token: Address, spender: Address, amount: bigint): TransactionRequest;
+export declare function buildRouterBuyTransaction(router: Address, parameters: {
+    token: Address;
+    minTokensOut: bigint;
+    deadline: bigint;
+    value: bigint;
+}): TransactionRequest;
+export declare function buildRouterSellTransaction(router: Address, parameters: {
+    token: Address;
+    tokensIn: bigint;
+    minAmountOut: bigint;
+    deadline: bigint;
+}): TransactionRequest;
+export declare function buildSwapExactInTransaction(router: Address, parameters: {
+    tokenIn: Address;
+    tokenOut: Address;
+    amountIn: bigint;
+    amountOutMin: bigint;
+    recipient: Address;
+    deadline: bigint;
+    value?: bigint;
+}): TransactionRequest;
+export declare function buildCollectFeesTransaction(feeController: Address, pair: Address, venue: "amm" | "lb"): TransactionRequest;
+export declare function toRpcTransactionRequest(request: TransactionRequest, gas: bigint): RpcTransactionRequest;
+export declare function parseRpcTransactionRequest(value: {
+    to: string;
+    data: string;
+    value: string;
+    gas: string;
+}): RpcTransactionRequest;
+export declare function verifyCreateLaunchTransaction(transaction: ConfirmedTransactionLike, launchpad: Address, account: Address, parameters: CreateLaunchParameters): DecodedLaunchpadTransaction;
+export declare function verifyCurveBuyTransaction(transaction: ConfirmedTransactionLike, launchpad: Address, account: Address, parameters: {
+    token: Address;
+    minTokensOut: bigint;
+    value: bigint;
+}): DecodedLaunchpadTransaction;
+export type DecodedLaunchpadTransaction = {
+    functionName: "createLaunch";
+    args: readonly [string, string, number, number, Address, string] | readonly [string, string, number, number, Address, string, number];
+} | {
+    functionName: "createLaunchVanity";
+    args: readonly [string, string, number, number, Address, string, Hex] | readonly [string, string, number, number, Address, string, Hex, number];
+} | {
+    functionName: "buy";
+    args: readonly [Address, bigint];
+} | {
+    functionName: "sell";
+    args: readonly [Address, bigint, bigint];
+} | {
+    functionName: "graduate";
+    args: readonly [Address];
+} | {
+    functionName: "claim";
+    args: readonly [];
+} | {
+    functionName: "claimAll";
+    args: readonly [Address];
+};
+export declare function decodeLaunchpadTransaction(data: Hex): DecodedLaunchpadTransaction;
+export type DecodedRouterTransaction = {
+    functionName: "buy";
+    args: readonly [Address, bigint, bigint];
+} | {
+    functionName: "sell";
+    args: readonly [Address, bigint, bigint, bigint];
+} | {
+    functionName: "swapExactIn";
+    args: readonly [Address, Address, bigint, bigint, Address, bigint];
+};
+export declare function decodeRouterTransaction(data: Hex): DecodedRouterTransaction;
+//# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

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