@ubi.fun/sdk 0.1.0

package/dist/clients/FlaunchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlaunchClient.d.ts","sourceRoot":"","sources":["../../src/clients/FlaunchClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,KAAK,EAMX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAE3C;;;GAGG;AACH,qBAAa,WAAW;IACtB,SAAgB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAEnD;;;;;OAKG;gBACS,OAAO,EAAE,OAAO,EAAE,KAAK,GAAE,KAAqB;IAW1D;;;;OAIG;IACH,OAAO,CAAC,WAAW,EAAE,OAAO;IAM5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM;IAMxB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM;CAKzB"}

package/dist/clients/FlaunchPositionManagerClient.d.cts

@@ -0,0 +1,117 @@
+import { type ReadContract, type Address, type Drift, type EventLog, HexString } from "@delvtech/drift";
+import { type Hex } from "viem";
+import { FlaunchPositionManagerAbi } from "../abi/FlaunchPositionManager.cjs";
+export type FlaunchPositionManagerABI = typeof FlaunchPositionManagerAbi;
+export type PoolCreatedLog = EventLog<FlaunchPositionManagerABI, "PoolCreated"> & {
+    timestamp: number;
+};
+export type PoolCreatedLogs = PoolCreatedLog[];
+export interface WatchPoolCreatedParams {
+    onPoolCreated: ({ logs, isFetchingFromStart, }: {
+        logs: PoolCreatedLogs;
+        isFetchingFromStart: boolean;
+    }) => void;
+    startBlockNumber?: bigint;
+}
+export type BaseSwapLog = EventLog<FlaunchPositionManagerABI, "PoolSwap"> & {
+    timestamp: number;
+};
+export type BuySwapLog = BaseSwapLog & {
+    type: "BUY";
+    delta: {
+        coinsBought: bigint;
+        usdcSold: bigint;
+        fees: {
+            isInUSDC: boolean;
+            amount: bigint;
+        };
+    };
+};
+export type SellSwapLog = BaseSwapLog & {
+    type: "SELL";
+    delta: {
+        coinsSold: bigint;
+        usdcBought: bigint;
+        fees: {
+            isInUSDC: boolean;
+            amount: bigint;
+        };
+    };
+};
+export type PoolSwapLog = BuySwapLog | SellSwapLog | BaseSwapLog;
+export type PoolSwapLogs = PoolSwapLog[];
+export interface WatchPoolSwapParams<TUSDCIsCurrencyZero extends boolean | undefined = undefined> {
+    onPoolSwap: ({ logs, isFetchingFromStart, }: {
+        logs: TUSDCIsCurrencyZero extends boolean ? (BuySwapLog | SellSwapLog)[] : BaseSwapLog[];
+        isFetchingFromStart: boolean;
+    }) => void;
+    usdcIsCurrencyZero?: TUSDCIsCurrencyZero;
+    startBlockNumber?: bigint;
+    filterByPoolId?: HexString;
+}
+/**
+ * Client for the PositionManager, the Uniswap v4 hook at the center of the
+ * protocol: it creates pools, collects and splits fees, and emits the
+ * PoolCreated / PoolSwap events integrators index.
+ *
+ * Launch coins through the FlaunchZap (see ReadWriteFlaunchZap) and trade
+ * through PoolSwap; this client is the read/event surface.
+ */
+export declare class ReadFlaunchPositionManager {
+    readonly contract: ReadContract<FlaunchPositionManagerABI>;
+    drift: Drift;
+    pollPoolCreatedNow?: () => Promise<void>;
+    pollPoolSwapNow?: () => Promise<void>;
+    readonly TOTAL_SUPPLY: bigint;
+    constructor(address: Address, drift?: Drift);
+    getFeeCalculator({ forFairLaunch }: {
+        forFairLaunch: boolean;
+    }): Promise<`0x${string}`>;
+    isValidCoin(coinAddress: Address): Promise<boolean>;
+    /**
+     * Reads the exact pool key for a coin, as stored by the hook. Prefer this
+     * over assembling the key by hand.
+     */
+    poolKey(coinAddress: Address): Promise<{
+        currency0: `0x${string}`;
+        currency1: `0x${string}`;
+        fee: number;
+        tickSpacing: number;
+        hooks: `0x${string}`;
+    }>;
+    /**
+     * The live fee distribution for a pool (swapFee, referrer, protocol shares
+     * in hundredths of a percent)
+     */
+    getPoolFeeDistribution(poolId: HexString): Promise<{
+        swapFee: number;
+        referrer: number;
+        protocol: number;
+        active: boolean;
+    }>;
+    /**
+     * The flaunch fee a launch would owe, in native units (msg.value; USDC at 18
+     * decimals on Arc). Reads through the initial price contract so sender fee
+     * exemptions apply.
+     */
+    getFlaunchingFee(params: {
+        sender: Address;
+        initialPriceParams: HexString;
+        slippagePercent?: number;
+    }): Promise<bigint>;
+    watchPoolCreated({ onPoolCreated, startBlockNumber, }: WatchPoolCreatedParams): Promise<{
+        cleanup: () => void;
+        pollPoolCreatedNow: () => Promise<void>;
+    }>;
+    /**
+     * Parses a transaction hash to extract PoolSwap events and return parsed swap data
+     * @param txHash - The transaction hash to parse
+     * @param usdcIsCurrencyZero - Whether USDC is currency0 in the pool (optional)
+     * @returns Parsed swap log or undefined if no PoolSwap event found
+     */
+    parseSwapTx(txHash: Hex, usdcIsCurrencyZero?: boolean): Promise<PoolSwapLog | undefined>;
+    watchPoolSwap<T extends boolean | undefined = undefined>({ onPoolSwap, usdcIsCurrencyZero, startBlockNumber, filterByPoolId, }: WatchPoolSwapParams<T>): Promise<{
+        cleanup: () => void;
+        pollPoolSwapNow: () => Promise<void>;
+    }>;
+}

package/dist/clients/FlaunchPositionManagerClient.d.ts

@@ -0,0 +1,118 @@
+import { type ReadContract, type Address, type Drift, type EventLog, HexString } from "@delvtech/drift";
+import { type Hex } from "viem";
+import { FlaunchPositionManagerAbi } from "../abi/FlaunchPositionManager.js";
+export type FlaunchPositionManagerABI = typeof FlaunchPositionManagerAbi;
+export type PoolCreatedLog = EventLog<FlaunchPositionManagerABI, "PoolCreated"> & {
+    timestamp: number;
+};
+export type PoolCreatedLogs = PoolCreatedLog[];
+export interface WatchPoolCreatedParams {
+    onPoolCreated: ({ logs, isFetchingFromStart, }: {
+        logs: PoolCreatedLogs;
+        isFetchingFromStart: boolean;
+    }) => void;
+    startBlockNumber?: bigint;
+}
+export type BaseSwapLog = EventLog<FlaunchPositionManagerABI, "PoolSwap"> & {
+    timestamp: number;
+};
+export type BuySwapLog = BaseSwapLog & {
+    type: "BUY";
+    delta: {
+        coinsBought: bigint;
+        usdcSold: bigint;
+        fees: {
+            isInUSDC: boolean;
+            amount: bigint;
+        };
+    };
+};
+export type SellSwapLog = BaseSwapLog & {
+    type: "SELL";
+    delta: {
+        coinsSold: bigint;
+        usdcBought: bigint;
+        fees: {
+            isInUSDC: boolean;
+            amount: bigint;
+        };
+    };
+};
+export type PoolSwapLog = BuySwapLog | SellSwapLog | BaseSwapLog;
+export type PoolSwapLogs = PoolSwapLog[];
+export interface WatchPoolSwapParams<TUSDCIsCurrencyZero extends boolean | undefined = undefined> {
+    onPoolSwap: ({ logs, isFetchingFromStart, }: {
+        logs: TUSDCIsCurrencyZero extends boolean ? (BuySwapLog | SellSwapLog)[] : BaseSwapLog[];
+        isFetchingFromStart: boolean;
+    }) => void;
+    usdcIsCurrencyZero?: TUSDCIsCurrencyZero;
+    startBlockNumber?: bigint;
+    filterByPoolId?: HexString;
+}
+/**
+ * Client for the PositionManager, the Uniswap v4 hook at the center of the
+ * protocol: it creates pools, collects and splits fees, and emits the
+ * PoolCreated / PoolSwap events integrators index.
+ *
+ * Launch coins through the FlaunchZap (see ReadWriteFlaunchZap) and trade
+ * through PoolSwap; this client is the read/event surface.
+ */
+export declare class ReadFlaunchPositionManager {
+    readonly contract: ReadContract<FlaunchPositionManagerABI>;
+    drift: Drift;
+    pollPoolCreatedNow?: () => Promise<void>;
+    pollPoolSwapNow?: () => Promise<void>;
+    readonly TOTAL_SUPPLY: bigint;
+    constructor(address: Address, drift?: Drift);
+    getFeeCalculator({ forFairLaunch }: {
+        forFairLaunch: boolean;
+    }): Promise<`0x${string}`>;
+    isValidCoin(coinAddress: Address): Promise<boolean>;
+    /**
+     * Reads the exact pool key for a coin, as stored by the hook. Prefer this
+     * over assembling the key by hand.
+     */
+    poolKey(coinAddress: Address): Promise<{
+        currency0: `0x${string}`;
+        currency1: `0x${string}`;
+        fee: number;
+        tickSpacing: number;
+        hooks: `0x${string}`;
+    }>;
+    /**
+     * The live fee distribution for a pool (swapFee, referrer, protocol shares
+     * in hundredths of a percent)
+     */
+    getPoolFeeDistribution(poolId: HexString): Promise<{
+        swapFee: number;
+        referrer: number;
+        protocol: number;
+        active: boolean;
+    }>;
+    /**
+     * The flaunch fee a launch would owe, in native units (msg.value; USDC at 18
+     * decimals on Arc). Reads through the initial price contract so sender fee
+     * exemptions apply.
+     */
+    getFlaunchingFee(params: {
+        sender: Address;
+        initialPriceParams: HexString;
+        slippagePercent?: number;
+    }): Promise<bigint>;
+    watchPoolCreated({ onPoolCreated, startBlockNumber, }: WatchPoolCreatedParams): Promise<{
+        cleanup: () => void;
+        pollPoolCreatedNow: () => Promise<void>;
+    }>;
+    /**
+     * Parses a transaction hash to extract PoolSwap events and return parsed swap data
+     * @param txHash - The transaction hash to parse
+     * @param usdcIsCurrencyZero - Whether USDC is currency0 in the pool (optional)
+     * @returns Parsed swap log or undefined if no PoolSwap event found
+     */
+    parseSwapTx(txHash: Hex, usdcIsCurrencyZero?: boolean): Promise<PoolSwapLog | undefined>;
+    watchPoolSwap<T extends boolean | undefined = undefined>({ onPoolSwap, usdcIsCurrencyZero, startBlockNumber, filterByPoolId, }: WatchPoolSwapParams<T>): Promise<{
+        cleanup: () => void;
+        pollPoolSwapNow: () => Promise<void>;
+    }>;
+}
+//# sourceMappingURL=FlaunchPositionManagerClient.d.ts.map

package/dist/clients/FlaunchPositionManagerClient.d.ts.map

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

package/dist/clients/FlaunchZapClient.d.cts

@@ -0,0 +1,127 @@
+import { type ReadContract, type Address, type Drift, type ReadWriteContract, type ReadWriteAdapter, type HexString } from "@delvtech/drift";
+import { FlaunchZapAbi } from "../abi/FlaunchZap.cjs";
+import { IPFSParams } from "../types.cjs";
+export type FlaunchZapABI = typeof FlaunchZapAbi;
+export interface FlaunchParams {
+    name: string;
+    symbol: string;
+    tokenUri: string;
+    /** Percent of supply (0-95) sold at the fixed fair launch price first. 0 for no fair launch. */
+    fairLaunchPercent: number;
+    /** Fair launch window in seconds (0 when fairLaunchPercent is 0). */
+    fairLaunchDuration: number;
+    /** Initial market cap in whole USD; $10,000 is the on-chain minimum and currently fee-free. */
+    initialMarketCapUSD: number;
+    /** Receives the Flaunch NFT (the revenue claim) and the creator revenue. */
+    creator: Address;
+    /** Creator vs floor-bid split of the creator share, 0-100 (the app defaults to 90). */
+    creatorFeeAllocationPercent: number;
+    /** 0 (or omit) to launch now, or a start timestamp within 30 days. */
+    flaunchAt?: bigint;
+    /** Coins the creator buys at the launch price in the same transaction. */
+    premineAmount?: bigint;
+    /** Referrer credited on the premine swap fee (only relevant with premineAmount). */
+    premineReferrer?: Address;
+    treasuryManagerParams?: {
+        manager?: Address;
+        /** Permissions contract for a newly deployed manager; zero address = open. */
+        permissions?: Address;
+        initializeData?: HexString;
+        depositData?: HexString;
+    };
+    /** Restrict the fair launch to a Merkle whitelist (zero root = open launch). */
+    whitelistParams?: {
+        merkleRoot: HexString;
+        merkleIPFSHash: string;
+        maxTokens: bigint;
+    };
+    /** Reserve part of the supply for a launch airdrop (zero values = none). */
+    airdropParams?: {
+        airdropIndex: bigint;
+        airdropAmount: bigint;
+        airdropEndTime: bigint;
+        merkleRoot: HexString;
+        merkleIPFSHash: string;
+    };
+}
+export interface FlaunchIPFSParams extends Omit<FlaunchParams, "tokenUri">, IPFSParams {
+}
+export interface FlaunchWithSplitManagerParams extends Omit<FlaunchParams, "treasuryManagerParams"> {
+    /**
+     * Other recipients and their percentages (0-100, fractional allowed, 5
+     * decimal places of precision). The creator automatically receives the exact
+     * remainder to 100%. A recipient can be an X-handle escrow address
+     * (ReadXHandleClaims.escrowAddress) to pay a handle that has not claimed yet.
+     */
+    splitReceivers: {
+        address: Address;
+        percent: number;
+    }[];
+}
+export interface FlaunchWithSplitManagerIPFSParams extends Omit<FlaunchWithSplitManagerParams, "tokenUri">, IPFSParams {
+}
+/**
+ * Base client for interacting with the FlaunchZap contract in read-only mode.
+ * The zap is the one-transaction launch entry point: token, Uniswap v4 pool,
+ * locked liquidity, fair launch, and the creator revenue stream.
+ */
+export declare class ReadFlaunchZap {
+    drift: Drift;
+    chainId: number;
+    readonly contract: ReadContract<FlaunchZapABI>;
+    readonly TOTAL_SUPPLY: bigint;
+    constructor(chainId: number, address: Address, drift?: Drift);
+    /**
+     * The msg.value required to flaunch: covers the premine purchase when there
+     * is one, plus the flaunch fee for market caps at or above the on-chain
+     * threshold. On Arc msg.value is native USDC at 18 decimals. Always send
+     * exactly this; sending less reverts with InsufficientFlaunchFee.
+     */
+    valueRequiredToFlaunch(params: {
+        premineAmount: bigint;
+        initialPriceParams: HexString;
+        slippagePercent?: number;
+    }): Promise<bigint>;
+}
+/**
+ * Extended client for interacting with the FlaunchZap contract with write capabilities
+ */
+export declare class ReadWriteFlaunchZap extends ReadFlaunchZap {
+    contract: ReadWriteContract<FlaunchZapABI>;
+    constructor(chainId: number, address: Address, drift?: Drift<ReadWriteAdapter>);
+    /**
+     * Flaunches a new token: creates the coin, its pool, locked liquidity, the
+     * fair launch (if any), and the creator revenue stream in one transaction
+     * @param params - Parameters for the flaunch
+     * @returns Transaction response for the flaunch creation
+     */
+    flaunch(params: FlaunchParams): Promise<`0x${string}`>;
+    /**
+     * Flaunches a new token, first pinning the image + metadata through the
+     * ubi.fun API to produce the tokenUri. To host the metadata yourself, pin
+     * it however you like and call `flaunch({ tokenUri })` instead.
+     */
+    flaunchIPFS(params: FlaunchIPFSParams): Promise<`0x${string}`>;
+    /**
+     * Flaunches a new token that splits the creator revenue between the creator
+     * and a list of recipients through the approved AddressFeeSplitManager.
+     * Shares are fixed at launch (5-decimal precision); the revenue NFT is
+     * deposited into the manager escrow rather than staying in the creator's
+     * wallet.
+     *
+     * Same layout the app uses: creatorShare/ownerShare are 0 and every payee is
+     * a recipient row (the manager requires recipient shares to total exactly
+     * 100%); the creator's row is the exact remainder after the listed
+     * receivers, so rounding can never brick the launch.
+     * @returns Transaction response for the flaunch creation
+     */
+    flaunchWithSplitManager(params: FlaunchWithSplitManagerParams): Promise<`0x${string}`>;
+    /**
+     * Flaunches a new token that splits the creator fees to the creator and a
+     * list of recipients, pinning the token metadata through the ubi.fun API
+     * first. To host the metadata yourself, pin it however you like and call
+     * `flaunchWithSplitManager({ tokenUri })` instead.
+     * @returns Promise resolving to the transaction response for the flaunch creation
+     */
+    flaunchIPFSWithSplitManager(params: FlaunchWithSplitManagerIPFSParams): Promise<`0x${string}`>;
+}

package/dist/clients/FlaunchZapClient.d.ts

@@ -0,0 +1,128 @@
+import { type ReadContract, type Address, type Drift, type ReadWriteContract, type ReadWriteAdapter, type HexString } from "@delvtech/drift";
+import { FlaunchZapAbi } from "../abi/FlaunchZap.js";
+import { IPFSParams } from "../types.js";
+export type FlaunchZapABI = typeof FlaunchZapAbi;
+export interface FlaunchParams {
+    name: string;
+    symbol: string;
+    tokenUri: string;
+    /** Percent of supply (0-95) sold at the fixed fair launch price first. 0 for no fair launch. */
+    fairLaunchPercent: number;
+    /** Fair launch window in seconds (0 when fairLaunchPercent is 0). */
+    fairLaunchDuration: number;
+    /** Initial market cap in whole USD; $10,000 is the on-chain minimum and currently fee-free. */
+    initialMarketCapUSD: number;
+    /** Receives the Flaunch NFT (the revenue claim) and the creator revenue. */
+    creator: Address;
+    /** Creator vs floor-bid split of the creator share, 0-100 (the app defaults to 90). */
+    creatorFeeAllocationPercent: number;
+    /** 0 (or omit) to launch now, or a start timestamp within 30 days. */
+    flaunchAt?: bigint;
+    /** Coins the creator buys at the launch price in the same transaction. */
+    premineAmount?: bigint;
+    /** Referrer credited on the premine swap fee (only relevant with premineAmount). */
+    premineReferrer?: Address;
+    treasuryManagerParams?: {
+        manager?: Address;
+        /** Permissions contract for a newly deployed manager; zero address = open. */
+        permissions?: Address;
+        initializeData?: HexString;
+        depositData?: HexString;
+    };
+    /** Restrict the fair launch to a Merkle whitelist (zero root = open launch). */
+    whitelistParams?: {
+        merkleRoot: HexString;
+        merkleIPFSHash: string;
+        maxTokens: bigint;
+    };
+    /** Reserve part of the supply for a launch airdrop (zero values = none). */
+    airdropParams?: {
+        airdropIndex: bigint;
+        airdropAmount: bigint;
+        airdropEndTime: bigint;
+        merkleRoot: HexString;
+        merkleIPFSHash: string;
+    };
+}
+export interface FlaunchIPFSParams extends Omit<FlaunchParams, "tokenUri">, IPFSParams {
+}
+export interface FlaunchWithSplitManagerParams extends Omit<FlaunchParams, "treasuryManagerParams"> {
+    /**
+     * Other recipients and their percentages (0-100, fractional allowed, 5
+     * decimal places of precision). The creator automatically receives the exact
+     * remainder to 100%. A recipient can be an X-handle escrow address
+     * (ReadXHandleClaims.escrowAddress) to pay a handle that has not claimed yet.
+     */
+    splitReceivers: {
+        address: Address;
+        percent: number;
+    }[];
+}
+export interface FlaunchWithSplitManagerIPFSParams extends Omit<FlaunchWithSplitManagerParams, "tokenUri">, IPFSParams {
+}
+/**
+ * Base client for interacting with the FlaunchZap contract in read-only mode.
+ * The zap is the one-transaction launch entry point: token, Uniswap v4 pool,
+ * locked liquidity, fair launch, and the creator revenue stream.
+ */
+export declare class ReadFlaunchZap {
+    drift: Drift;
+    chainId: number;
+    readonly contract: ReadContract<FlaunchZapABI>;
+    readonly TOTAL_SUPPLY: bigint;
+    constructor(chainId: number, address: Address, drift?: Drift);
+    /**
+     * The msg.value required to flaunch: covers the premine purchase when there
+     * is one, plus the flaunch fee for market caps at or above the on-chain
+     * threshold. On Arc msg.value is native USDC at 18 decimals. Always send
+     * exactly this; sending less reverts with InsufficientFlaunchFee.
+     */
+    valueRequiredToFlaunch(params: {
+        premineAmount: bigint;
+        initialPriceParams: HexString;
+        slippagePercent?: number;
+    }): Promise<bigint>;
+}
+/**
+ * Extended client for interacting with the FlaunchZap contract with write capabilities
+ */
+export declare class ReadWriteFlaunchZap extends ReadFlaunchZap {
+    contract: ReadWriteContract<FlaunchZapABI>;
+    constructor(chainId: number, address: Address, drift?: Drift<ReadWriteAdapter>);
+    /**
+     * Flaunches a new token: creates the coin, its pool, locked liquidity, the
+     * fair launch (if any), and the creator revenue stream in one transaction
+     * @param params - Parameters for the flaunch
+     * @returns Transaction response for the flaunch creation
+     */
+    flaunch(params: FlaunchParams): Promise<`0x${string}`>;
+    /**
+     * Flaunches a new token, first pinning the image + metadata through the
+     * ubi.fun API to produce the tokenUri. To host the metadata yourself, pin
+     * it however you like and call `flaunch({ tokenUri })` instead.
+     */
+    flaunchIPFS(params: FlaunchIPFSParams): Promise<`0x${string}`>;
+    /**
+     * Flaunches a new token that splits the creator revenue between the creator
+     * and a list of recipients through the approved AddressFeeSplitManager.
+     * Shares are fixed at launch (5-decimal precision); the revenue NFT is
+     * deposited into the manager escrow rather than staying in the creator's
+     * wallet.
+     *
+     * Same layout the app uses: creatorShare/ownerShare are 0 and every payee is
+     * a recipient row (the manager requires recipient shares to total exactly
+     * 100%); the creator's row is the exact remainder after the listed
+     * receivers, so rounding can never brick the launch.
+     * @returns Transaction response for the flaunch creation
+     */
+    flaunchWithSplitManager(params: FlaunchWithSplitManagerParams): Promise<`0x${string}`>;
+    /**
+     * Flaunches a new token that splits the creator fees to the creator and a
+     * list of recipients, pinning the token metadata through the ubi.fun API
+     * first. To host the metadata yourself, pin it however you like and call
+     * `flaunchWithSplitManager({ tokenUri })` instead.
+     * @returns Promise resolving to the transaction response for the flaunch creation
+     */
+    flaunchIPFSWithSplitManager(params: FlaunchWithSplitManagerIPFSParams): Promise<`0x${string}`>;
+}
+//# sourceMappingURL=FlaunchZapClient.d.ts.map

package/dist/clients/FlaunchZapClient.d.ts.map

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

package/dist/clients/InitialPriceClient.d.cts

@@ -0,0 +1,32 @@
+import { type ReadContract, type Address, type Drift, type HexString } from "@delvtech/drift";
+import { InitialPriceAbi } from "../abi/InitialPrice.cjs";
+export type InitialPriceABI = typeof InitialPriceAbi;
+/**
+ * Client for the deployed IInitialPrice implementation (UsdcMarketCappedPrice):
+ * turns the launcher's chosen initial market cap (USDC, 6 decimals, abi-encoded
+ * as a single uint256) into the pool's starting price and the flaunch fee.
+ */
+export declare class ReadInitialPrice {
+    readonly contract: ReadContract<InitialPriceABI>;
+    constructor(address: Address, drift?: Drift);
+    /**
+     * The flaunch fee for a launch, in the chain's native units (18 decimals on
+     * Arc, where msg.value is USDC at 18 decimals). Zero for market caps below
+     * the on-chain threshold and for fee-exempt senders.
+     * @param params.sender - The address that will send the launch
+     * @param params.initialPriceParams - The abi-encoded initial market cap
+     */
+    getFlaunchingFee(params: {
+        sender: Address;
+        initialPriceParams: HexString;
+    }): Promise<bigint>;
+    /**
+     * The starting sqrt price for a launch
+     * @param params.usdcIsCurrencyZero - Whether USDC sorts as currency0
+     * @param params.initialPriceParams - The abi-encoded initial market cap
+     */
+    getSqrtPriceX96(params: {
+        usdcIsCurrencyZero: boolean;
+        initialPriceParams: HexString;
+    }): Promise<bigint>;
+}

package/dist/clients/InitialPriceClient.d.ts

@@ -0,0 +1,33 @@
+import { type ReadContract, type Address, type Drift, type HexString } from "@delvtech/drift";
+import { InitialPriceAbi } from "../abi/InitialPrice.js";
+export type InitialPriceABI = typeof InitialPriceAbi;
+/**
+ * Client for the deployed IInitialPrice implementation (UsdcMarketCappedPrice):
+ * turns the launcher's chosen initial market cap (USDC, 6 decimals, abi-encoded
+ * as a single uint256) into the pool's starting price and the flaunch fee.
+ */
+export declare class ReadInitialPrice {
+    readonly contract: ReadContract<InitialPriceABI>;
+    constructor(address: Address, drift?: Drift);
+    /**
+     * The flaunch fee for a launch, in the chain's native units (18 decimals on
+     * Arc, where msg.value is USDC at 18 decimals). Zero for market caps below
+     * the on-chain threshold and for fee-exempt senders.
+     * @param params.sender - The address that will send the launch
+     * @param params.initialPriceParams - The abi-encoded initial market cap
+     */
+    getFlaunchingFee(params: {
+        sender: Address;
+        initialPriceParams: HexString;
+    }): Promise<bigint>;
+    /**
+     * The starting sqrt price for a launch
+     * @param params.usdcIsCurrencyZero - Whether USDC sorts as currency0
+     * @param params.initialPriceParams - The abi-encoded initial market cap
+     */
+    getSqrtPriceX96(params: {
+        usdcIsCurrencyZero: boolean;
+        initialPriceParams: HexString;
+    }): Promise<bigint>;
+}
+//# sourceMappingURL=InitialPriceClient.d.ts.map

package/dist/clients/InitialPriceClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InitialPriceClient.d.ts","sourceRoot":"","sources":["../../src/clients/InitialPriceClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,SAAS,EAEf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAErD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,SAAgB,QAAQ,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;gBAE5C,OAAO,EAAE,OAAO,EAAE,KAAK,GAAE,KAAqB;IAW1D;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,SAAS,CAAA;KAAE;IAO3E;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE;QACtB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,kBAAkB,EAAE,SAAS,CAAC;KAC/B;CAOF"}

package/dist/clients/MemecoinClient.d.cts

@@ -0,0 +1,66 @@
+import { type ReadContract, type Address, type Drift, type ReadWriteContract } from "@delvtech/drift";
+import { MemecoinAbi } from "../abi/Memecoin.cjs";
+export type MemecoinABI = typeof MemecoinAbi;
+/**
+ * Client for interacting with Memecoin (ERC20) contracts in read-only mode
+ * Provides methods to query basic token information and balances
+ */
+export declare class ReadMemecoin {
+    readonly contract: ReadContract<MemecoinABI>;
+    /**
+     * Creates a new ReadMemecoin instance
+     * @param address - The address of the Memecoin contract
+     * @param drift - Optional drift instance for contract interactions (creates new instance if not provided)
+     * @throws Error if address is not provided
+     */
+    constructor(address: Address, drift?: Drift);
+    /**
+     * Gets the name of the token
+     * @returns Promise<string> - The name of the token
+     */
+    name(): Promise<string>;
+    /**
+     * Gets the symbol of the token
+     * @returns Promise<string> - The symbol of the token
+     */
+    symbol(): Promise<string>;
+    /**
+     * Gets the token URI containing metadata
+     * @returns Promise<string> - The token URI
+     */
+    tokenURI(): Promise<string>;
+    /**
+     * Gets the decimals of the token
+     * @returns Promise<number> - The decimals of the token
+     */
+    decimals(): Promise<number>;
+    /**
+     * Gets the total supply of the token
+     * @returns Promise<bigint> - The total supply
+     */
+    totalSupply(): Promise<bigint>;
+    /**
+     * Gets the token balance of a specific user
+     * @param user - The address of the user to check
+     * @returns Promise<bigint> - The token balance
+     */
+    balanceOf(user: Address): Promise<bigint>;
+    /**
+     * Gets the allowance of an ERC20 token to a spender
+     * @param owner - The address of the owner to check
+     * @param spender - The address of the spender to check
+     * @returns Promise<bigint> - The allowance of the coin to the spender
+     */
+    allowance(owner: Address, spender: Address): Promise<bigint>;
+}
+export declare class ReadWriteMemecoin extends ReadMemecoin {
+    contract: ReadWriteContract<MemecoinABI>;
+    constructor(address: Address, drift?: Drift);
+    /**
+     * Approves an amount of the token to be spent by another address
+     * @param spender - The address of the spender to approve
+     * @param amount - The amount of the token to approve
+     * @returns Promise<void> - The transaction receipt
+     */
+    approve(spender: Address, amount: bigint): Promise<`0x${string}`>;
+}