@vleap/warps 3.0.0-alpha.9 → 3.0.0-alpha.91

package/dist/index.d.cts

@@ -0,0 +1,870 @@
+import QRCodeStyling from 'qr-code-styling';
+
+type WarpBrand = {
+    protocol: string;
+    name: string;
+    description: string;
+    logo: string;
+    urls?: WarpBrandUrls;
+    colors?: WarpBrandColors;
+    cta?: WarpBrandCta;
+    meta?: WarpBrandMeta;
+};
+type WarpBrandUrls = {
+    web?: string;
+};
+type WarpBrandColors = {
+    primary?: string;
+    secondary?: string;
+};
+type WarpBrandCta = {
+    title: string;
+    description: string;
+    label: string;
+    url: string;
+};
+type WarpBrandMeta = {
+    hash: string;
+    creator: string;
+    createdAt: string;
+};
+
+type ClientCacheConfig = {
+    ttl?: number;
+    type?: WarpCacheType;
+};
+type WarpCacheType = 'memory' | 'localStorage';
+
+type WarpChainEnv = 'mainnet' | 'testnet' | 'devnet';
+type ProtocolName = 'warp' | 'brand' | 'abi';
+
+type WarpTrustStatus = 'unverified' | 'verified' | 'blacklisted';
+type WarpRegistryInfo = {
+    hash: string;
+    alias: string | null;
+    trust: WarpTrustStatus;
+    owner: string;
+    createdAt: number;
+    upgradedAt: number;
+    brand: string | null;
+    upgrade: string | null;
+};
+type WarpRegistryConfigInfo = {
+    unitPrice: bigint;
+    admins: string[];
+};
+
+type WarpExecution = {
+    success: boolean;
+    warp: Warp;
+    action: number;
+    user: string | null;
+    txHash: string | null;
+    tx: WarpAdapterGenericTransaction | null;
+    next: WarpExecutionNextInfo | null;
+    values: any[];
+    valuesRaw: any[];
+    results: WarpExecutionResults;
+    messages: WarpExecutionMessages;
+};
+type WarpExecutionNextInfo = {
+    identifier: string | null;
+    url: string;
+}[];
+type WarpExecutionResults = Record<WarpResultName, any | null>;
+type WarpExecutionMessages = Record<WarpMessageName, string | null>;
+
+type ClientIndexConfig = {
+    url?: string;
+    apiKey?: string;
+    searchParamName?: string;
+};
+type WarpSearchResult = {
+    hits: WarpSearchHit[];
+};
+type WarpSearchHit = {
+    hash: string;
+    alias: string;
+    name: string;
+    title: string;
+    description: string;
+    preview: string;
+    status: string;
+    category: string;
+    featured: boolean;
+};
+
+interface TransformRunner {
+    run(code: string, context: any): Promise<any>;
+}
+type ClientTransformConfig = {
+    runner?: TransformRunner | null;
+};
+
+type WarpUserWallets = Record<WarpChain, string | null>;
+type WarpProviderConfig = Record<WarpChainEnv, string>;
+type WarpClientConfig = {
+    env: WarpChainEnv;
+    clientUrl?: string;
+    currentUrl?: string;
+    vars?: Record<string, string | number>;
+    user?: {
+        wallets?: WarpUserWallets;
+    };
+    preferences?: {
+        explorers?: Record<WarpChain, WarpExplorerName>;
+    };
+    providers?: Record<WarpChain, WarpProviderConfig>;
+    schema?: {
+        warp?: string;
+        brand?: string;
+    };
+    cache?: ClientCacheConfig;
+    transform?: ClientTransformConfig;
+    index?: ClientIndexConfig;
+};
+type WarpCacheConfig = {
+    ttl?: number;
+};
+type AdapterFactory = (config: WarpClientConfig, fallback?: Adapter) => Adapter;
+type Adapter = {
+    chainInfo: WarpChainInfo;
+    prefix: string;
+    builder: () => CombinedWarpBuilder;
+    executor: AdapterWarpExecutor;
+    results: AdapterWarpResults;
+    serializer: AdapterWarpSerializer;
+    registry: AdapterWarpRegistry;
+    explorer: AdapterWarpExplorer;
+    abiBuilder: () => AdapterWarpAbiBuilder;
+    brandBuilder: () => AdapterWarpBrandBuilder;
+    dataLoader: AdapterWarpDataLoader;
+    registerTypes?: (typeRegistry: WarpTypeRegistry) => void;
+};
+type WarpAdapterGenericTransaction = any;
+type WarpAdapterGenericRemoteTransaction = any;
+type WarpAdapterGenericValue = any;
+type WarpAdapterGenericType = any;
+interface WarpTypeHandler {
+    stringToNative(value: string): any;
+    nativeToString(value: any): string;
+}
+interface WarpTypeRegistry {
+    registerType(typeName: string, handler: WarpTypeHandler): void;
+    hasType(typeName: string): boolean;
+    getHandler(typeName: string): WarpTypeHandler | undefined;
+    getRegisteredTypes(): string[];
+}
+interface BaseWarpBuilder {
+    createFromRaw(encoded: string): Promise<Warp>;
+    createFromUrl(url: string): Promise<Warp>;
+    setName(name: string): BaseWarpBuilder;
+    setTitle(title: string): BaseWarpBuilder;
+    setDescription(description: string): BaseWarpBuilder;
+    setPreview(preview: string): BaseWarpBuilder;
+    setActions(actions: WarpAction[]): BaseWarpBuilder;
+    addAction(action: WarpAction): BaseWarpBuilder;
+    build(): Promise<Warp>;
+}
+interface AdapterWarpBuilder {
+    createInscriptionTransaction(warp: Warp): WarpAdapterGenericTransaction;
+    createFromTransaction(tx: WarpAdapterGenericTransaction, validate?: boolean): Promise<Warp>;
+    createFromTransactionHash(hash: string, cache?: WarpCacheConfig): Promise<Warp | null>;
+}
+type CombinedWarpBuilder = AdapterWarpBuilder & BaseWarpBuilder;
+interface AdapterWarpAbiBuilder {
+    createFromRaw(encoded: string): Promise<any>;
+    createFromTransaction(tx: WarpAdapterGenericTransaction): Promise<any>;
+    createFromTransactionHash(hash: string, cache?: WarpCacheConfig): Promise<any | null>;
+}
+interface AdapterWarpBrandBuilder {
+    createInscriptionTransaction(brand: WarpBrand): WarpAdapterGenericTransaction;
+    createFromTransaction(tx: WarpAdapterGenericTransaction, validate?: boolean): Promise<WarpBrand>;
+    createFromTransactionHash(hash: string, cache?: WarpCacheConfig): Promise<WarpBrand | null>;
+}
+interface AdapterWarpExecutor {
+    createTransaction(executable: WarpExecutable): Promise<WarpAdapterGenericTransaction>;
+    executeQuery(executable: WarpExecutable): Promise<WarpExecution>;
+    preprocessInput(chain: WarpChainInfo, input: string, type: WarpActionInputType, value: string): Promise<string>;
+    signMessage(message: string, privateKey: string): Promise<string>;
+}
+interface AdapterWarpResults {
+    getTransactionExecutionResults(warp: Warp, tx: WarpAdapterGenericRemoteTransaction): Promise<WarpExecution>;
+}
+interface AdapterWarpSerializer {
+    typedToString(value: WarpAdapterGenericValue): string;
+    typedToNative(value: WarpAdapterGenericValue): [WarpActionInputType, WarpNativeValue];
+    nativeToTyped(type: WarpActionInputType, value: WarpNativeValue): WarpAdapterGenericValue;
+    nativeToType(type: BaseWarpActionInputType): WarpAdapterGenericType;
+    stringToTyped(value: string): WarpAdapterGenericValue;
+}
+interface AdapterWarpRegistry {
+    init(): Promise<void>;
+    getRegistryConfig(): WarpRegistryConfigInfo;
+    createWarpRegisterTransaction(txHash: string, alias?: string | null, brand?: string | null): Promise<WarpAdapterGenericTransaction>;
+    createWarpUnregisterTransaction(txHash: string): Promise<WarpAdapterGenericTransaction>;
+    createWarpUpgradeTransaction(alias: string, txHash: string): Promise<WarpAdapterGenericTransaction>;
+    createWarpAliasSetTransaction(txHash: string, alias: string): Promise<WarpAdapterGenericTransaction>;
+    createWarpVerifyTransaction(txHash: string): Promise<WarpAdapterGenericTransaction>;
+    createWarpTransferOwnershipTransaction(txHash: string, newOwner: string): Promise<WarpAdapterGenericTransaction>;
+    createBrandRegisterTransaction(txHash: string): Promise<WarpAdapterGenericTransaction>;
+    createWarpBrandingTransaction(warpHash: string, brandHash: string): Promise<WarpAdapterGenericTransaction>;
+    getInfoByAlias(alias: string, cache?: WarpCacheConfig): Promise<{
+        registryInfo: WarpRegistryInfo | null;
+        brand: WarpBrand | null;
+    }>;
+    getInfoByHash(hash: string, cache?: WarpCacheConfig): Promise<{
+        registryInfo: WarpRegistryInfo | null;
+        brand: WarpBrand | null;
+    }>;
+    getUserWarpRegistryInfos(user?: string): Promise<WarpRegistryInfo[]>;
+    getUserBrands(user?: string): Promise<WarpBrand[]>;
+    fetchBrand(hash: string, cache?: WarpCacheConfig): Promise<WarpBrand | null>;
+}
+interface AdapterWarpExplorer {
+    getAccountUrl(address: string): string;
+    getTransactionUrl(hash: string): string;
+    getAssetUrl(identifier: string): string;
+    getContractUrl(address: string): string;
+}
+interface WarpDataLoaderOptions {
+    page?: number;
+    size?: number;
+}
+interface AdapterWarpDataLoader {
+    getAccount(address: string): Promise<WarpChainAccount>;
+    getAccountAssets(address: string): Promise<WarpChainAsset[]>;
+    getAsset(identifier: string): Promise<WarpChainAsset | null>;
+    getAction(identifier: string, awaitCompleted?: boolean): Promise<WarpChainAction | null>;
+    getAccountActions(address: string, options?: WarpDataLoaderOptions): Promise<WarpChainAction[]>;
+}
+
+type WarpChainAccount = {
+    chain: WarpChain;
+    address: string;
+    balance: bigint;
+};
+type WarpChainAssetValue = {
+    identifier: string;
+    amount: bigint;
+};
+type WarpChainAsset = {
+    chain: WarpChain;
+    identifier: string;
+    name: string;
+    amount?: bigint;
+    decimals?: number;
+    logoUrl?: string;
+};
+type WarpChainAction = {
+    chain: WarpChain;
+    id: string;
+    sender: string;
+    receiver: string;
+    value: bigint;
+    function: string;
+    status: WarpChainActionStatus;
+    createdAt: string;
+    error?: string | null;
+    tx?: WarpAdapterGenericRemoteTransaction | null;
+};
+type WarpChainActionStatus = 'pending' | 'success' | 'failed';
+
+type WarpChain = string;
+type WarpExplorerName = string;
+type WarpChainInfo = {
+    name: string;
+    displayName: string;
+    chainId: string;
+    blockTime: number;
+    addressHrp: string;
+    defaultApiUrl: string;
+    nativeToken: WarpChainAsset;
+};
+type WarpIdType = 'hash' | 'alias';
+type WarpVarPlaceholder = string;
+type WarpResultName = string;
+type WarpResulutionPath = string;
+type WarpMessageName = string;
+type Warp = {
+    protocol: string;
+    name: string;
+    title: string;
+    description: string | null;
+    bot?: string;
+    preview?: string;
+    vars?: Record<WarpVarPlaceholder, string>;
+    actions: WarpAction[];
+    next?: string;
+    results?: Record<WarpResultName, WarpResulutionPath>;
+    messages?: Record<WarpMessageName, string>;
+    meta?: WarpMeta;
+};
+type WarpMeta = {
+    chain: WarpChain;
+    hash: string;
+    creator: string;
+    createdAt: string;
+};
+type WarpAction = WarpTransferAction | WarpContractAction | WarpQueryAction | WarpCollectAction | WarpLinkAction;
+type WarpActionIndex = number;
+type WarpActionType = 'transfer' | 'contract' | 'query' | 'collect' | 'link';
+type WarpTransferAction = {
+    type: WarpActionType;
+    chain?: WarpChain;
+    label: string;
+    description?: string | null;
+    address?: string;
+    data?: string;
+    value?: string;
+    transfers?: string[];
+    inputs?: WarpActionInput[];
+    next?: string;
+};
+type WarpContractAction = {
+    type: WarpActionType;
+    chain?: WarpChain;
+    label: string;
+    description?: string | null;
+    address?: string;
+    func?: string | null;
+    args?: string[];
+    value?: string;
+    gasLimit: number;
+    transfers?: string[];
+    abi?: string;
+    inputs?: WarpActionInput[];
+    next?: string;
+};
+type WarpQueryAction = {
+    type: WarpActionType;
+    chain?: WarpChain;
+    label: string;
+    description?: string | null;
+    address?: string;
+    func?: string;
+    args?: string[];
+    abi?: string;
+    inputs?: WarpActionInput[];
+    next?: string;
+};
+type WarpCollectAction = {
+    type: WarpActionType;
+    chain?: WarpChain;
+    label: string;
+    description?: string | null;
+    destination: {
+        url: string;
+        method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+        headers?: Record<string, string>;
+    };
+    inputs?: WarpActionInput[];
+    next?: string;
+};
+type WarpLinkAction = {
+    type: WarpActionType;
+    chain?: WarpChain;
+    label: string;
+    description?: string | null;
+    url: string;
+    inputs?: WarpActionInput[];
+};
+type WarpActionInputSource = 'field' | 'query' | 'user:wallet';
+type BaseWarpActionInputType = 'string' | 'uint8' | 'uint16' | 'uint32' | 'uint64' | 'uint128' | 'uint256' | 'biguint' | 'bool' | 'address' | 'hex' | string;
+type WarpActionInputType = string;
+type WarpNativeValue = string | number | bigint | boolean | WarpChainAssetValue | null | WarpNativeValue[];
+type WarpActionInputPosition = 'receiver' | 'value' | 'transfer' | `arg:${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10}` | 'data' | 'chain';
+type WarpActionInputModifier = 'scale';
+type WarpActionInput = {
+    name: string;
+    as?: string;
+    description?: string | null;
+    bot?: string;
+    type: WarpActionInputType;
+    position?: WarpActionInputPosition;
+    source: WarpActionInputSource;
+    required?: boolean;
+    min?: number | WarpVarPlaceholder;
+    max?: number | WarpVarPlaceholder;
+    pattern?: string;
+    patternDescription?: string;
+    options?: string[] | {
+        [key: string]: string;
+    };
+    modifier?: string;
+    default?: string | number | boolean;
+};
+type ResolvedInput = {
+    input: WarpActionInput;
+    value: string | null;
+};
+type WarpContract = {
+    address: string;
+    owner: string;
+    verified: boolean;
+};
+type WarpContractVerification = {
+    codeHash: string;
+    abi: object;
+};
+type WarpExecutable = {
+    chain: WarpChainInfo;
+    warp: Warp;
+    action: number;
+    destination: string;
+    args: string[];
+    value: bigint;
+    transfers: WarpChainAssetValue[];
+    data: string | null;
+    resolvedInputs: ResolvedInput[];
+};
+
+type WarpAbi = {
+    protocol: string;
+    content: WarpAbiContents;
+    meta?: WarpMeta;
+};
+type WarpAbiContents = {
+    name?: string;
+    constructor?: any;
+    upgradeConstructor?: any;
+    endpoints?: any[];
+    types?: Record<string, any>;
+    events?: any[];
+};
+
+declare enum WarpChainName {
+    Multiversx = "multiversx",
+    Vibechain = "vibechain",
+    Sui = "sui",
+    Ethereum = "ethereum",
+    Base = "base",
+    Arbitrum = "arbitrum",
+    Fastset = "fastset"
+}
+declare const WarpConstants: {
+    HttpProtocolPrefix: string;
+    IdentifierParamName: string;
+    IdentifierParamSeparator: string[];
+    IdentifierParamSeparatorDefault: string;
+    IdentifierChainDefault: string;
+    IdentifierType: {
+        Alias: WarpIdType;
+        Hash: WarpIdType;
+    };
+    Source: {
+        UserWallet: string;
+    };
+    Globals: {
+        UserWallet: {
+            Placeholder: string;
+            Accessor: (bag: InterpolationBag) => string | null | undefined;
+        };
+        ChainApiUrl: {
+            Placeholder: string;
+            Accessor: (bag: InterpolationBag) => string;
+        };
+        ChainAddressHrp: {
+            Placeholder: string;
+            Accessor: (bag: InterpolationBag) => string;
+        };
+    };
+    Vars: {
+        Query: string;
+        Env: string;
+    };
+    ArgParamsSeparator: string;
+    ArgCompositeSeparator: string;
+    Transform: {
+        Prefix: string;
+    };
+};
+declare const WarpInputTypes: {
+    Option: string;
+    Optional: string;
+    List: string;
+    Variadic: string;
+    Composite: string;
+    String: string;
+    U8: string;
+    U16: string;
+    U32: string;
+    U64: string;
+    U128: string;
+    U256: string;
+    Biguint: string;
+    Boolean: string;
+    Address: string;
+    Asset: string;
+    Hex: string;
+};
+
+type InterpolationBag = {
+    config: WarpClientConfig;
+    chain: WarpChainName;
+    chainInfo: WarpChainInfo;
+};
+
+declare const WarpProtocolVersions: {
+    Warp: string;
+    Brand: string;
+    Abi: string;
+};
+declare const WarpConfig: {
+    LatestWarpSchemaUrl: string;
+    LatestBrandSchemaUrl: string;
+    DefaultClientUrl: (env: WarpChainEnv) => "https://usewarp.to" | "https://testnet.usewarp.to" | "https://devnet.usewarp.to";
+    DefaultChainPrefix: string;
+    SuperClientUrls: string[];
+    AvailableActionInputSources: WarpActionInputSource[];
+    AvailableActionInputTypes: WarpActionInputType[];
+    AvailableActionInputPositions: WarpActionInputPosition[];
+};
+
+interface CryptoProvider {
+    getRandomBytes(size: number): Promise<Uint8Array>;
+}
+declare class BrowserCryptoProvider implements CryptoProvider {
+    getRandomBytes(size: number): Promise<Uint8Array>;
+}
+declare class NodeCryptoProvider implements CryptoProvider {
+    getRandomBytes(size: number): Promise<Uint8Array>;
+}
+declare function getCryptoProvider(): CryptoProvider;
+declare function setCryptoProvider(provider: CryptoProvider): void;
+declare function getRandomBytes(size: number, cryptoProvider?: CryptoProvider): Promise<Uint8Array>;
+declare function bytesToHex(bytes: Uint8Array): string;
+declare function bytesToBase64(bytes: Uint8Array): string;
+declare function getRandomHex(length: number, cryptoProvider?: CryptoProvider): Promise<string>;
+declare function testCryptoAvailability(): Promise<{
+    randomBytes: boolean;
+    environment: 'browser' | 'nodejs' | 'unknown';
+}>;
+declare function createCryptoProvider(): CryptoProvider;
+
+declare const findWarpAdapterForChain: (chain: WarpChain, adapters: Adapter[]) => Adapter;
+declare const findWarpAdapterByPrefix: (prefix: string, adapters: Adapter[]) => Adapter;
+declare const getLatestProtocolIdentifier: (name: ProtocolName) => string;
+declare const getWarpActionByIndex: (warp: Warp, index: number) => WarpAction;
+declare const findWarpExecutableAction: (warp: Warp) => {
+    action: WarpAction;
+    actionIndex: WarpActionIndex;
+};
+declare const shiftBigintBy: (value: bigint | string | number, decimals: number) => bigint;
+declare const toPreviewText: (text: string, maxChars?: number) => string;
+declare const replacePlaceholders: (message: string, bag: Record<string, any>) => string;
+declare const applyResultsToMessages: (warp: Warp, results: Record<string, any>) => Record<string, string>;
+
+declare const getWarpInfoFromIdentifier: (prefixedIdentifier: string) => {
+    chainPrefix: string;
+    type: WarpIdType;
+    identifier: string;
+    identifierBase: string;
+} | null;
+declare const extractIdentifierInfoFromUrl: (url: string) => {
+    chainPrefix: string;
+    type: WarpIdType;
+    identifier: string;
+    identifierBase: string;
+} | null;
+
+declare const getNextInfo: (config: WarpClientConfig, adapters: Adapter[], warp: Warp, actionIndex: number, results: WarpExecutionResults) => WarpExecutionNextInfo | null;
+
+declare const getProviderUrl: (config: WarpClientConfig, chain: WarpChain, env: WarpChainEnv, defaultProvider: string) => string;
+declare const getProviderConfig: (config: WarpClientConfig, chain: WarpChain) => WarpProviderConfig | undefined;
+
+declare const extractCollectResults: (warp: Warp, response: any, actionIndex: number, inputs: ResolvedInput[], transformRunner?: TransformRunner | null) => Promise<{
+    values: any[];
+    results: WarpExecutionResults;
+}>;
+declare const evaluateResultsCommon: (warp: Warp, baseResults: WarpExecutionResults, actionIndex: number, inputs: ResolvedInput[], transformRunner?: TransformRunner | null) => Promise<WarpExecutionResults>;
+/**
+ * Parses out[N] notation and returns the action index (1-based) or null if invalid.
+ * Also handles plain "out" which defaults to action index 1.
+ */
+declare const parseResultsOutIndex: (resultPath: string) => number | null;
+
+/**
+ * Signing utilities for creating and validating signed messages
+ * Works with any crypto provider or uses automatic detection
+ */
+
+interface SignableMessage {
+    wallet: string;
+    nonce: string;
+    expiresAt: string;
+    purpose: string;
+}
+type HttpAuthHeaders = Record<string, string> & {
+    'X-Signer-Wallet': string;
+    'X-Signer-Signature': string;
+    'X-Signer-Nonce': string;
+    'X-Signer-ExpiresAt': string;
+};
+/**
+ * Creates a signable message with standard security fields
+ * This can be used for any type of proof or authentication
+ */
+declare function createSignableMessage(walletAddress: string, purpose: string, cryptoProvider?: CryptoProvider, expiresInMinutes?: number): Promise<{
+    message: string;
+    nonce: string;
+    expiresAt: string;
+}>;
+/**
+ * Creates a signable message for HTTP authentication
+ * This is a convenience function that uses the standard format
+ */
+declare function createAuthMessage(walletAddress: string, appName: string, cryptoProvider?: CryptoProvider, purpose?: string): Promise<{
+    message: string;
+    nonce: string;
+    expiresAt: string;
+}>;
+/**
+ * Creates HTTP authentication headers from a signature
+ */
+declare function createAuthHeaders(walletAddress: string, signature: string, nonce: string, expiresAt: string): HttpAuthHeaders;
+/**
+ * Creates HTTP authentication headers for a wallet using the provided signing function
+ */
+declare function createHttpAuthHeaders(walletAddress: string, signMessage: (message: string) => Promise<string>, appName: string, cryptoProvider?: CryptoProvider): Promise<HttpAuthHeaders>;
+/**
+ * Validates a signed message by checking expiration
+ */
+declare function validateSignedMessage(expiresAt: string): boolean;
+/**
+ * Parses a signed message to extract its components
+ */
+declare function parseSignedMessage(message: string): SignableMessage;
+
+declare const string: (value: string) => string;
+declare const u8: (value: number) => string;
+declare const u16: (value: number) => string;
+declare const u32: (value: number) => string;
+declare const u64: (value: bigint | number) => string;
+declare const biguint: (value: bigint | string | number) => string;
+declare const boolean: (value: boolean) => string;
+declare const address: (value: string) => string;
+declare const asset: (value: WarpChainAsset) => string;
+declare const hex: (value: string) => string;
+
+declare class WarpBrandBuilder {
+    private config;
+    private pendingBrand;
+    constructor(config: WarpClientConfig);
+    createFromRaw(encoded: string, validateSchema?: boolean): Promise<WarpBrand>;
+    setName(name: string): WarpBrandBuilder;
+    setDescription(description: string): WarpBrandBuilder;
+    setLogo(logo: string): WarpBrandBuilder;
+    setUrls(urls: WarpBrandUrls): WarpBrandBuilder;
+    setColors(colors: WarpBrandColors): WarpBrandBuilder;
+    setCta(cta: WarpBrandCta): WarpBrandBuilder;
+    build(): Promise<WarpBrand>;
+    private ensure;
+    private ensureValidSchema;
+}
+
+declare class WarpBuilder implements BaseWarpBuilder {
+    protected readonly config: WarpClientConfig;
+    private pendingWarp;
+    constructor(config: WarpClientConfig);
+    createFromRaw(encoded: string, validate?: boolean): Promise<Warp>;
+    createFromUrl(url: string): Promise<Warp>;
+    setName(name: string): WarpBuilder;
+    setTitle(title: string): WarpBuilder;
+    setDescription(description: string): WarpBuilder;
+    setPreview(preview: string): WarpBuilder;
+    setActions(actions: WarpAction[]): WarpBuilder;
+    addAction(action: WarpAction): WarpBuilder;
+    build(): Promise<Warp>;
+    getDescriptionPreview(description: string, maxChars?: number): string;
+    private ensure;
+    private validate;
+}
+
+declare const CacheTtl: {
+    OneMinute: number;
+    OneHour: number;
+    OneDay: number;
+    OneWeek: number;
+    OneMonth: number;
+    OneYear: number;
+};
+declare const WarpCacheKey: {
+    Warp: (env: WarpChainEnv, id: string) => string;
+    WarpAbi: (env: WarpChainEnv, id: string) => string;
+    WarpExecutable: (env: WarpChainEnv, id: string, action: number) => string;
+    RegistryInfo: (env: WarpChainEnv, id: string) => string;
+    Brand: (env: WarpChainEnv, hash: string) => string;
+};
+declare class WarpCache {
+    private strategy;
+    constructor(type?: WarpCacheType);
+    private selectStrategy;
+    set<T>(key: string, value: T, ttl: number): void;
+    get<T>(key: string): T | null;
+    forget(key: string): void;
+    clear(): void;
+}
+
+type ExecutionHandlers = {
+    onExecuted?: (result: WarpExecution) => void;
+    onError?: (params: {
+        message: string;
+    }) => void;
+    onSignRequest?: (params: {
+        message: string;
+        chain: WarpChainInfo;
+    }) => Promise<string>;
+};
+declare class WarpExecutor {
+    private config;
+    private adapters;
+    private handlers?;
+    private factory;
+    private serializer;
+    constructor(config: WarpClientConfig, adapters: Adapter[], handlers?: ExecutionHandlers | undefined);
+    execute(warp: Warp, inputs: string[]): Promise<{
+        tx: WarpAdapterGenericTransaction | null;
+        chain: WarpChainInfo | null;
+    }>;
+    evaluateResults(warp: Warp, chain: WarpChain, tx: WarpAdapterGenericRemoteTransaction): Promise<void>;
+    private executeCollect;
+}
+
+declare class WarpFactory {
+    private config;
+    private adapters;
+    private url;
+    private serializer;
+    private cache;
+    constructor(config: WarpClientConfig, adapters: Adapter[]);
+    createExecutable(warp: Warp, actionIndex: number, inputs: string[]): Promise<WarpExecutable>;
+    getChainInfoForAction(action: WarpAction, inputs?: string[]): Promise<WarpChainInfo>;
+    getResolvedInputs(chain: WarpChain, action: WarpAction, inputArgs: string[]): Promise<ResolvedInput[]>;
+    getModifiedInputs(inputs: ResolvedInput[]): ResolvedInput[];
+    preprocessInput(chain: WarpChain, input: string): Promise<string>;
+    private getPreparedArgs;
+    private tryGetChainFromInputs;
+}
+
+declare class WarpIndex {
+    private config;
+    constructor(config: WarpClientConfig);
+    search(query: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<WarpSearchHit[]>;
+}
+
+declare class WarpLinkBuilder {
+    private readonly config;
+    private readonly adapters;
+    constructor(config: WarpClientConfig, adapters: Adapter[]);
+    isValid(url: string): boolean;
+    build(chain: WarpChain, type: WarpIdType, id: string): string;
+    buildFromPrefixedIdentifier(identifier: string): string | null;
+    generateQrCode(chain: WarpChain, type: WarpIdType, id: string, size?: number, background?: string, color?: string, logoColor?: string): QRCodeStyling;
+}
+
+type DetectionResult = {
+    match: boolean;
+    url: string;
+    warp: Warp | null;
+    chain: WarpChain | null;
+    registryInfo: WarpRegistryInfo | null;
+    brand: WarpBrand | null;
+};
+type DetectionResultFromHtml = {
+    match: boolean;
+    results: {
+        url: string;
+        warp: Warp;
+    }[];
+};
+declare class WarpLinkDetecter {
+    private config;
+    private adapters;
+    constructor(config: WarpClientConfig, adapters: Adapter[]);
+    isValid(url: string): boolean;
+    detectFromHtml(content: string): Promise<DetectionResultFromHtml>;
+    detect(url: string, cache?: WarpCacheConfig): Promise<DetectionResult>;
+}
+
+declare class WarpClient {
+    private readonly config;
+    private adapters;
+    constructor(config: WarpClientConfig, adapters: Adapter[]);
+    getConfig(): WarpClientConfig;
+    getAdapters(): Adapter[];
+    addAdapter(adapter: Adapter): WarpClient;
+    createExecutor(handlers?: ExecutionHandlers): WarpExecutor;
+    detectWarp(urlOrId: string, cache?: WarpCacheConfig): Promise<DetectionResult>;
+    executeWarp(identifier: string, inputs: string[], handlers?: ExecutionHandlers, options?: {
+        cache?: WarpCacheConfig;
+    }): Promise<{
+        tx: WarpAdapterGenericTransaction | null;
+        chain: WarpChainInfo | null;
+        evaluateResults: (remoteTx: WarpAdapterGenericRemoteTransaction) => Promise<void>;
+    }>;
+    createInscriptionTransaction(chain: WarpChain, warp: Warp): WarpAdapterGenericTransaction;
+    createFromTransaction(chain: WarpChain, tx: WarpAdapterGenericRemoteTransaction, validate?: boolean): Promise<Warp>;
+    createFromTransactionHash(hash: string, cache?: WarpCacheConfig): Promise<Warp | null>;
+    signMessage(chain: WarpChain, message: string, privateKey: string): Promise<string>;
+    getExplorer(chain: WarpChain): AdapterWarpExplorer;
+    getResults(chain: WarpChain): AdapterWarpResults;
+    getRegistry(chain: WarpChain): Promise<AdapterWarpRegistry>;
+    getDataLoader(chain: WarpChain): AdapterWarpDataLoader;
+    get factory(): WarpFactory;
+    get index(): WarpIndex;
+    get linkBuilder(): WarpLinkBuilder;
+    createBuilder(chain: WarpChain): CombinedWarpBuilder;
+    createAbiBuilder(chain: WarpChain): AdapterWarpAbiBuilder;
+    createBrandBuilder(chain: WarpChain): AdapterWarpBrandBuilder;
+}
+
+declare class WarpInterpolator {
+    private config;
+    private adapter;
+    constructor(config: WarpClientConfig, adapter: Adapter);
+    apply(config: WarpClientConfig, warp: Warp): Promise<Warp>;
+    applyGlobals(config: WarpClientConfig, warp: Warp): Promise<Warp>;
+    applyVars(config: WarpClientConfig, warp: Warp): Warp;
+    private applyRootGlobals;
+    private applyActionGlobals;
+}
+
+declare class WarpLogger {
+    private static isTestEnv;
+    static info(...args: any[]): void;
+    static warn(...args: any[]): void;
+    static error(...args: any[]): void;
+}
+
+declare class WarpSerializer {
+    private typeRegistry;
+    setTypeRegistry(typeRegistry: WarpTypeRegistry): void;
+    nativeToString(type: WarpActionInputType, value: WarpNativeValue): string;
+    stringToNative(value: string): [WarpActionInputType, WarpNativeValue];
+}
+
+declare class WarpTypeRegistryImpl implements WarpTypeRegistry {
+    private typeHandlers;
+    registerType(typeName: string, handler: WarpTypeHandler): void;
+    hasType(typeName: string): boolean;
+    getHandler(typeName: string): WarpTypeHandler | undefined;
+    getRegisteredTypes(): string[];
+}
+
+type ValidationResult = {
+    valid: boolean;
+    errors: ValidationError[];
+};
+type ValidationError = string;
+declare class WarpValidator {
+    private config;
+    constructor(config: WarpClientConfig);
+    validate(warp: Warp): Promise<ValidationResult>;
+    private validateMaxOneValuePosition;
+    private validateVariableNamesAndResultNamesUppercase;
+    private validateAbiIsSetIfApplicable;
+    private validateSchema;
+}
+
+export { type Adapter, type AdapterFactory, type AdapterWarpAbiBuilder, type AdapterWarpBrandBuilder, type AdapterWarpBuilder, type AdapterWarpDataLoader, type AdapterWarpExecutor, type AdapterWarpExplorer, type AdapterWarpRegistry, type AdapterWarpResults, type AdapterWarpSerializer, type BaseWarpActionInputType, type BaseWarpBuilder, BrowserCryptoProvider, CacheTtl, type ClientIndexConfig, type ClientTransformConfig, type CombinedWarpBuilder, type CryptoProvider, type DetectionResult, type DetectionResultFromHtml, type ExecutionHandlers, type HttpAuthHeaders, type InterpolationBag, NodeCryptoProvider, type ProtocolName, type ResolvedInput, type SignableMessage, type TransformRunner, type Warp, type WarpAbi, type WarpAbiContents, type WarpAction, type WarpActionIndex, type WarpActionInput, type WarpActionInputModifier, type WarpActionInputPosition, type WarpActionInputSource, type WarpActionInputType, type WarpActionType, type WarpAdapterGenericRemoteTransaction, type WarpAdapterGenericTransaction, type WarpAdapterGenericType, type WarpAdapterGenericValue, type WarpBrand, WarpBrandBuilder, type WarpBrandColors, type WarpBrandCta, type WarpBrandMeta, type WarpBrandUrls, WarpBuilder, WarpCache, type WarpCacheConfig, WarpCacheKey, type WarpChain, type WarpChainAccount, type WarpChainAction, type WarpChainActionStatus, type WarpChainAsset, type WarpChainAssetValue, type WarpChainEnv, type WarpChainInfo, WarpChainName, WarpClient, type WarpClientConfig, type WarpCollectAction, WarpConfig, WarpConstants, type WarpContract, type WarpContractAction, type WarpContractVerification, type WarpDataLoaderOptions, type WarpExecutable, type WarpExecution, type WarpExecutionMessages, type WarpExecutionNextInfo, type WarpExecutionResults, WarpExecutor, type WarpExplorerName, WarpFactory, type WarpIdType, WarpIndex, WarpInputTypes, WarpInterpolator, type WarpLinkAction, WarpLinkBuilder, WarpLinkDetecter, WarpLogger, type WarpMessageName, type WarpMeta, type WarpNativeValue, WarpProtocolVersions, type WarpProviderConfig, type WarpQueryAction, type WarpRegistryConfigInfo, type WarpRegistryInfo, type WarpResultName, type WarpResulutionPath, type WarpSearchHit, type WarpSearchResult, WarpSerializer, type WarpTransferAction, type WarpTrustStatus, type WarpTypeHandler, type WarpTypeRegistry, WarpTypeRegistryImpl, type WarpUserWallets, WarpValidator, type WarpVarPlaceholder, address, applyResultsToMessages, asset, biguint, boolean, bytesToBase64, bytesToHex, createAuthHeaders, createAuthMessage, createCryptoProvider, createHttpAuthHeaders, createSignableMessage, evaluateResultsCommon, extractCollectResults, extractIdentifierInfoFromUrl, findWarpAdapterByPrefix, findWarpAdapterForChain, findWarpExecutableAction, getCryptoProvider, getLatestProtocolIdentifier, getNextInfo, getProviderConfig, getProviderUrl, getRandomBytes, getRandomHex, getWarpActionByIndex, getWarpInfoFromIdentifier, hex, parseResultsOutIndex, parseSignedMessage, replacePlaceholders, setCryptoProvider, shiftBigintBy, string, testCryptoAvailability, toPreviewText, u16, u32, u64, u8, validateSignedMessage };