@towns-labs/app-framework 4.0.0

package/dist/modules/payments.d.ts

@@ -0,0 +1,89 @@
+import type { Address, Hex } from 'viem';
+import type { AgentHandler, BasePayload } from '../app';
+import type { Price, RouteConfig } from 'x402/types';
+export declare const USDC_ADDRESSES: Record<number, Address>;
+export interface PendingPayment {
+    command: string;
+    channelId: string;
+    userId: string;
+    /** The eventId of the interaction request message (to delete after signing) */
+    interactionEventId: string;
+    event: BasePayload & {
+        command: string;
+        args: string[];
+        mentions: any[];
+        replyId: string | undefined;
+        threadId: string | undefined;
+    };
+    params: TransferAuthorizationParams;
+}
+export declare function chainIdToNetwork(chainId: number): 'base' | 'base-sepolia';
+export declare function getUsdcAddress(chainId: number): Address;
+export interface TransferAuthorizationParams {
+    from: Address;
+    to: Address;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: Hex;
+    chainId: number;
+    verifyingContract: Address;
+}
+export interface TypedData {
+    types: {
+        [key: string]: Array<{
+            name: string;
+            type: string;
+        }>;
+    };
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: Address;
+    };
+    primaryType: string;
+    message: {
+        [key: string]: any;
+    };
+}
+/**
+ * Generate a unique nonce for USDC authorization
+ * Uses crypto-safe random bytes
+ */
+export declare function generateNonce(): Hex;
+/**
+ * Get validity window for authorization
+ * validAfter: current timestamp
+ * validBefore: current timestamp + 1 hour
+ */
+export declare function getValidityWindow(): {
+    validAfter: bigint;
+    validBefore: bigint;
+};
+/**
+ * Build EIP-712 typed data for USDC transferWithAuthorization signature request
+ * Synchronous version for sending to client - no contract calls needed
+ */
+export declare function buildTransferAuthorizationTypedDataForSigning(params: TransferAuthorizationParams): TypedData;
+/**
+ * Simplified payment request builder
+ * Returns all data needed to track and verify the payment
+ */
+export declare function createPaymentRequest(handler: AgentHandler, event: BasePayload, chainId: number, fromAddress: Address, recipientAddress: Address, paymentConfig: RouteConfig, command: string): Promise<{
+    signatureId: string;
+    params: TransferAuthorizationParams;
+    eventId: string;
+}>;
+/**
+ * Parses a USDC price to atomic units (6 decimals).
+ * Handles dollar signs, commas, and decimal amounts.
+ * Only string and number inputs are supported.
+ *
+ * @example
+ * parseUSDCPrice("$1.00")     // 1000000n
+ * parseUSDCPrice(1.50)        // 1500000n
+ * parseUSDCPrice("$1,000.00") // 1000000000n
+ */
+export declare function parseUSDCPrice(price: Price): bigint;
+//# sourceMappingURL=payments.d.ts.map

package/dist/modules/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/modules/payments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAGxC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEpD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAGlD,CAAA;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,WAAW,GAAG;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,EAAE,CAAA;QACd,QAAQ,EAAE,GAAG,EAAE,CAAA;QACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAC/B,CAAA;IACD,MAAM,EAAE,2BAA2B,CAAA;CACtC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CASzE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMvD;AAGD,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE;QACH,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KACvD,CAAA;IACD,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,iBAAiB,EAAE,OAAO,CAAA;KAC7B,CAAA;IACD,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KACrB,CAAA;CACJ;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAGnC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACtB,CAMA;AAED;;;GAGG;AACH,wBAAgB,6CAA6C,CACzD,MAAM,EAAE,2BAA2B,GACpC,SAAS,CA4BX;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,EACpB,gBAAgB,EAAE,OAAO,EACzB,aAAa,EAAE,WAAW,EAC1B,OAAO,EAAE,MAAM;;;;GAyClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAkBnD"}

package/dist/modules/payments.js

@@ -0,0 +1,139 @@
+import { keccak256 } from 'viem';
+import { baseSepolia, base } from 'viem/chains';
+export const USDC_ADDRESSES = {
+    [baseSepolia.id]: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+    [base.id]: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+};
+export function chainIdToNetwork(chainId) {
+    switch (chainId) {
+        case base.id:
+            return 'base';
+        case baseSepolia.id:
+            return 'base-sepolia';
+        default:
+            throw new Error(`Unsupported chain ID: ${chainId}`);
+    }
+}
+export function getUsdcAddress(chainId) {
+    const address = USDC_ADDRESSES[chainId];
+    if (!address) {
+        throw new Error(`USDC address not found for chain ID: ${chainId}`);
+    }
+    return address;
+}
+/**
+ * Generate a unique nonce for USDC authorization
+ * Uses crypto-safe random bytes
+ */
+export function generateNonce() {
+    const randomBytes = crypto.getRandomValues(new Uint8Array(32));
+    return keccak256(randomBytes);
+}
+/**
+ * Get validity window for authorization
+ * validAfter: current timestamp
+ * validBefore: current timestamp + 1 hour
+ */
+export function getValidityWindow() {
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    return {
+        validAfter: now,
+        validBefore: now + 3600n, // 1 hour
+    };
+}
+/**
+ * Build EIP-712 typed data for USDC transferWithAuthorization signature request
+ * Synchronous version for sending to client - no contract calls needed
+ */
+export function buildTransferAuthorizationTypedDataForSigning(params) {
+    return {
+        types: {
+            TransferWithAuthorization: [
+                { name: 'from', type: 'address' },
+                { name: 'to', type: 'address' },
+                { name: 'value', type: 'uint256' },
+                { name: 'validAfter', type: 'uint256' },
+                { name: 'validBefore', type: 'uint256' },
+                { name: 'nonce', type: 'bytes32' },
+            ],
+        },
+        domain: {
+            name: 'USDC',
+            version: '2',
+            chainId: params.chainId,
+            verifyingContract: params.verifyingContract,
+        },
+        primaryType: 'TransferWithAuthorization',
+        message: {
+            from: params.from,
+            to: params.to,
+            value: params.value.toString(),
+            validAfter: params.validAfter.toString(),
+            validBefore: params.validBefore.toString(),
+            nonce: params.nonce,
+        },
+    };
+}
+/**
+ * Simplified payment request builder
+ * Returns all data needed to track and verify the payment
+ */
+export async function createPaymentRequest(handler, event, chainId, fromAddress, recipientAddress, paymentConfig, command) {
+    const usdcAddr = getUsdcAddress(chainId);
+    const nonce = generateNonce();
+    const { validAfter, validBefore } = getValidityWindow();
+    const value = parseUSDCPrice(paymentConfig.price);
+    const params = {
+        from: fromAddress,
+        to: recipientAddress,
+        value: value,
+        validAfter,
+        validBefore,
+        nonce,
+        chainId: chainId,
+        verifyingContract: usdcAddr,
+    };
+    const typedData = buildTransferAuthorizationTypedDataForSigning(params);
+    // Format price for display
+    const priceDisplay = typeof paymentConfig.price === 'string' || typeof paymentConfig.price === 'number'
+        ? String(paymentConfig.price)
+        : JSON.stringify(paymentConfig.price);
+    const result = await handler.sendInteractionRequest(event.channelId, {
+        type: 'signature',
+        method: 'typed_data',
+        data: JSON.stringify(typedData),
+        chainId: params.chainId.toString(),
+        signerWallet: fromAddress,
+        title: `Payment Required for /${command} • ${priceDisplay} USDC`,
+        subtitle: `Sign to authorize payment`,
+    });
+    return {
+        signatureId: result.requestId,
+        params,
+        eventId: result.eventId,
+    };
+}
+/**
+ * Parses a USDC price to atomic units (6 decimals).
+ * Handles dollar signs, commas, and decimal amounts.
+ * Only string and number inputs are supported.
+ *
+ * @example
+ * parseUSDCPrice("$1.00")     // 1000000n
+ * parseUSDCPrice(1.50)        // 1500000n
+ * parseUSDCPrice("$1,000.00") // 1000000000n
+ */
+export function parseUSDCPrice(price) {
+    if (typeof price !== 'string' && typeof price !== 'number') {
+        throw new Error(`parseUSDCPrice only supports string or number inputs, got: ${typeof price}`);
+    }
+    const rawStr = String(price);
+    const sanitized = rawStr.replace(/[$,\s]/g, '').trim();
+    if (!/^\d+(\.\d{0,6})?$/.test(sanitized)) {
+        throw new Error(`Invalid USDC price format: ${JSON.stringify(price)}`);
+    }
+    const [whole, frac = ''] = sanitized.split('.');
+    const paddedFrac = frac.padEnd(6, '0').slice(0, 6);
+    return BigInt(whole || '0') * 1000000n + BigInt(paddedFrac);
+}
+//# sourceMappingURL=payments.js.map

package/dist/modules/payments.js.map

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

package/dist/modules/user.d.ts

@@ -0,0 +1,17 @@
+import type { Address } from 'viem';
+import type { AppRegistryRpcClient } from '@towns-labs/sdk';
+export type UserInfo = {
+    /** The user's address (0x string) */
+    id: Address;
+    /** The user's display name from the app registry */
+    displayName: string;
+    /** The user's username from the app registry */
+    username: string;
+};
+export declare class UserInfoCache {
+    private cache;
+    get(userId: string): UserInfo | undefined;
+    set(userId: string, info: UserInfo): void;
+}
+export declare function getUserBulk(userIds: Address[], cache: UserInfoCache, getAppRegistryClient: () => Promise<AppRegistryRpcClient>): Promise<Map<Address, UserInfo | undefined>>;
+//# sourceMappingURL=user.d.ts.map

package/dist/modules/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/modules/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAG3D,MAAM,MAAM,QAAQ,GAAG;IACnB,qCAAqC;IACrC,EAAE,EAAE,OAAO,CAAA;IACX,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;CACnB,CAAA;AASD,qBAAa,aAAa;IACtB,OAAO,CAAC,KAAK,CAAoC;IAEjD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAUzC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;CAM5C;AAED,wBAAsB,WAAW,CAC7B,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,aAAa,EACpB,oBAAoB,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,GAC1D,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAsC7C"}

package/dist/modules/user.js

@@ -0,0 +1,54 @@
+import { addressFromUserId, userIdFromAddress } from '@towns-labs/sdk';
+const USER_INFO_TTL_MS = 5 * 60 * 1000; // 5 minutes
+export class UserInfoCache {
+    cache = new Map();
+    get(userId) {
+        const entry = this.cache.get(userId.toLowerCase());
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(userId.toLowerCase());
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(userId, info) {
+        this.cache.set(userId.toLowerCase(), {
+            value: info,
+            expiresAt: Date.now() + USER_INFO_TTL_MS,
+        });
+    }
+}
+export async function getUserBulk(userIds, cache, getAppRegistryClient) {
+    const looked = userIds.map((id) => [id, cache.get(id)]);
+    const uncached = looked.filter(([, v]) => !v).map(([id]) => id);
+    const result = new Map(looked.filter(([, v]) => v).map(([id, v]) => [id, v]));
+    if (uncached.length === 0)
+        return result;
+    try {
+        const appRegistry = await getAppRegistryClient();
+        const response = await appRegistry.getBatchEntityNames({
+            entityIds: uncached.map((userId) => addressFromUserId(userId)),
+        });
+        const found = new Map((response.entities ?? []).map((entity) => {
+            const resolvedUserId = userIdFromAddress(entity.entityId);
+            const info = {
+                id: resolvedUserId,
+                displayName: entity.displayName ?? '',
+                username: entity.username ?? '',
+            };
+            cache.set(resolvedUserId, info);
+            return [resolvedUserId.toLowerCase(), info];
+        }));
+        for (const userId of uncached) {
+            result.set(userId, found.get(userId.toLowerCase()));
+        }
+    }
+    catch {
+        for (const userId of uncached) {
+            result.set(userId, undefined);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=user.js.map

package/dist/modules/user.js.map

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

package/dist/snapshot-getter.d.ts

@@ -0,0 +1,21 @@
+import type { PlainMessage, Snapshot } from '@towns-labs/proto';
+import type { ParsedStreamResponse, Prettify } from '@towns-labs/sdk';
+type RemoveContent<T extends string> = T extends `${infer Prefix}Content` ? Prefix : T;
+type SnapshotContent = Exclude<Snapshot['content'], {
+    case: undefined;
+}>;
+type SnapshotTypeMap = {
+    [K in SnapshotContent['case']]: Extract<SnapshotContent, {
+        case: K;
+    }>['value'];
+};
+type GenerateGetters<SnapshotCase extends keyof SnapshotTypeMap, SnapshotType = PlainMessage<SnapshotTypeMap[SnapshotCase]>> = {
+    [Prop in NonNullable<keyof SnapshotType> as `get${Capitalize<RemoveContent<SnapshotCase>>}${Capitalize<string & Prop>}`]: (streamId: string) => Promise<SnapshotType[Prop]>;
+};
+type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type GetterFunctions = UnionToIntersection<{
+    [K in keyof SnapshotTypeMap]: GenerateGetters<K>;
+}[keyof SnapshotTypeMap]>;
+export declare const SnapshotGetter: (getStream: (streamId: string) => Promise<ParsedStreamResponse>) => Prettify<GetterFunctions>;
+export {};
+//# sourceMappingURL=snapshot-getter.d.ts.map

package/dist/snapshot-getter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-getter.d.ts","sourceRoot":"","sources":["../src/snapshot-getter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAoB,MAAM,mBAAmB,CAAA;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAIrE,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAA;AAGtF,KAAK,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAA;AAGxE,KAAK,eAAe,GAAG;KAClB,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,OAAO,CAAC;CACjF,CAAA;AAGD,KAAK,eAAe,CAChB,YAAY,SAAS,MAAM,eAAe,EAC1C,YAAY,GAAG,YAAY,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,IAC1D;KACC,IAAI,IAAI,WAAW,CAChB,MAAM,YAAY,CACrB,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,CAC/E,QAAQ,EAAE,MAAM,KACf,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CACnC,CAAA;AAGD,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC7F,CAAC,GACD,KAAK,CAAA;AAGX,KAAK,eAAe,GAAG,mBAAmB,CACtC;KACK,CAAC,IAAI,MAAM,eAAe,GAAG,eAAe,CAAC,CAAC,CAAC;CACnD,CAAC,MAAM,eAAe,CAAC,CAC3B,CAAA;AAsBD,eAAO,MAAM,cAAc,GAAI,WAAW,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,KAyBpF,QAAQ,CAAC,eAAe,CAAC,CAAA"}

package/dist/snapshot-getter.js

@@ -0,0 +1,27 @@
+const getFromSnapshot = (getStream) => async (streamId, snapshotCase, propertyKey) => {
+    const stream = await getStream(streamId);
+    if (stream.snapshot.content.case === snapshotCase) {
+        const snapshotValue = stream.snapshot.content.value;
+        return snapshotValue[propertyKey];
+    }
+    return undefined;
+};
+export const SnapshotGetter = (getStream) => new Proxy({}, {
+    get(_target, prop) {
+        return async (streamId) => {
+            // Parse the getter name to extract snapshot type and property
+            const propName = String(prop);
+            // Match pattern like getSpaceInception, getUserMemberships, etc.
+            const match = propName.match(/^get([A-Z][a-z]+)([A-Z][a-zA-Z]+)$/);
+            if (!match) {
+                throw new Error(`Invalid getter name: ${propName}`);
+            }
+            const [, snapshotType, propertyName] = match;
+            const snapshotCase = `${snapshotType.toLowerCase()}Content`;
+            const property = (propertyName.charAt(0).toLowerCase() +
+                propertyName.slice(1));
+            return getFromSnapshot(getStream)(streamId, snapshotCase, property);
+        };
+    },
+});
+//# sourceMappingURL=snapshot-getter.js.map

package/dist/snapshot-getter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-getter.js","sourceRoot":"","sources":["../src/snapshot-getter.ts"],"names":[],"mappings":"AA4CA,MAAM,eAAe,GACjB,CAAC,SAA8D,EAAE,EAAE,CACnE,KAAK,EACD,QAAgB,EAChB,YAAmB,EACnB,WAAiB,EACqC,EAAE;IACxD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;IACxC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAoC,CAAA;QAClF,OAAO,aAAa,CAAC,WAAW,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,SAAS,CAAA;AACpB,CAAC,CAAA;AAEL,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAA8D,EAAE,EAAE,CAC7F,IAAI,KAAK,CACL,EAAE,EACF;IACI,GAAG,CAAC,OAAO,EAAE,IAAY;QACrB,OAAO,KAAK,EAAE,QAAgB,EAAE,EAAE;YAC9B,8DAA8D;YAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAE7B,iEAAiE;YACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAA;YAClE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAA;YACvD,CAAC;YAED,MAAM,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,GAAG,KAAK,CAAA;YAC5C,MAAM,YAAY,GACd,GAAG,YAAY,CAAC,WAAW,EAAE,SAAkC,CAAA;YACnE,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;gBAClD,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAoD,CAAA;YAE7E,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;QACvE,CAAC,CAAA;IACL,CAAC;CACJ,CACyB,CAAA"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@towns-labs/app-framework",
+  "version": "4.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "eslint --format unix ./src --max-warnings=0",
+    "lint:fix": "bun run lint --fix",
+    "test": "vitest run",
+    "test:ci": "vitest run --silent=passed-only",
+    "test:watch": "vitest --watch",
+    "typecheck": "tsc --noEmit",
+    "watch": "tsc --watch"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.9.0",
+    "@connectrpc/connect-node": "^2.1.0",
+    "@standard-schema/spec": "^1.0.0-beta.9",
+    "@towns-labs/encryption": "^4.0.0",
+    "@towns-labs/proto": "^4.0.0",
+    "@towns-labs/sdk": "^4.0.0",
+    "@towns-labs/sdk-crypto": "^4.0.0",
+    "@towns-labs/utils": "^4.0.0",
+    "@towns-labs/web3": "^4.0.0",
+    "ethers": "^5.8.0",
+    "image-size": "^2.0.2",
+    "jsonwebtoken": "^9.0.2",
+    "nanoevents": "^9.1.0",
+    "superjson": "^2.2.2",
+    "x402": "^0.7.3"
+  },
+  "devDependencies": {
+    "@hono/node-server": "^1.19.9",
+    "@towns-labs/contracts": "^4.0.0",
+    "@towns-labs/relayer-client": "^4.0.0",
+    "@types/jsonwebtoken": "^9.0.9",
+    "@types/node": "^20.14.8",
+    "@typescript-eslint/eslint-plugin": "^8.29.0",
+    "@typescript-eslint/parser": "^8.29.0",
+    "eslint": "^8.57.1",
+    "eslint-import-resolver-typescript": "^4.3.2",
+    "eslint-plugin-import-x": "^4.10.2",
+    "eslint-plugin-tsdoc": "^0.3.0",
+    "fake-indexeddb": "^6.0.1",
+    "hono": "^4.11.7",
+    "nanoid": "^4.0.0",
+    "typescript": "~5.8.3",
+    "viem": "2.45.1",
+    "vitest": "^3.2.3",
+    "zod": "^4.3.6"
+  },
+  "files": [
+    "/dist",
+    "package.json"
+  ],
+  "peerDependencies": {
+    "hono": ">=4",
+    "viem": "2.x"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}