@towns-labs/agent 2.0.1

package/dist/smart-account.js

@@ -0,0 +1,132 @@
+import { zeroAddress, } from 'viem';
+import { getStorageAt, readContract } from 'viem/actions';
+import walletLinkAbi from '@towns-labs/generated/dev/abis/WalletLink.abi';
+/**
+ * The default slot for the implementation address for ERC-1967 Proxies
+ * keccak256('eip1967.proxy.implementation')) - 1
+ */
+export const PROXY_STORAGE_SLOT = '0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc';
+/**
+ * Known modular account implementation addresses
+ */
+export const MODULAR_ACCOUNT_IMPLEMENTATIONS = {
+    /**
+     * Semi modular smart account bytecode for new accounts
+     * New accounts get this address as their implementation
+     */
+    NEW: '0x000000000000c5A9089039570Dd36455b5C07383',
+    /**
+     * Storage only smart account bytecode for existing accounts
+     * Upgraded accounts get this address as their implementation
+     * https://github.com/alchemyplatform/modular-account/blob/develop/src/account/SemiModularAccountStorageOnly.sol
+     */
+    UPGRADED: '0x0000000000006E2f9d80CaEc0Da6500f005EB25A',
+};
+function isModularAccount(implementationAddress) {
+    const lowerImpl = implementationAddress.toLowerCase();
+    return (lowerImpl === MODULAR_ACCOUNT_IMPLEMENTATIONS.NEW.toLowerCase() ||
+        lowerImpl === MODULAR_ACCOUNT_IMPLEMENTATIONS.UPGRADED.toLowerCase());
+}
+/**
+ * Check if an address has a deployed modular smart account implementation
+ * @param client - The public RPC viem client
+ * @param address - The address to check
+ * @returns True if the address has a deployed modular smart account implementation, false otherwise
+ */
+export async function checkSmartAccountImplementation(viem, address) {
+    try {
+        const storageValue = await getStorageAt(viem, {
+            address,
+            slot: PROXY_STORAGE_SLOT,
+        });
+        if (!storageValue) {
+            return false;
+        }
+        // The storage slot contains a full bytes32, but we want only the last 20 bytes.
+        // Slice off the leading `0x` and the first 12 bytes (24 characters), leaving the last 20 bytes, then prefix with `0x`.
+        const implementationAddress = `0x${storageValue.slice(26)}`;
+        if (implementationAddress === zeroAddress) {
+            return false;
+        }
+        // Only return modular accounts (skip simple accounts)
+        if (!isModularAccount(implementationAddress)) {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function getLinkedWalletsWithRootKey(viem, wallet, walletLinkAddress) {
+    try {
+        const linkedWallets = await readContract(viem, {
+            address: walletLinkAddress,
+            abi: walletLinkAbi,
+            functionName: 'getWalletsByRootKey',
+            args: [wallet],
+        });
+        if (!linkedWallets) {
+            const possibleRoot = await readContract(viem, {
+                address: walletLinkAddress,
+                abi: walletLinkAbi,
+                functionName: 'getRootKeyForWallet',
+                args: [wallet],
+            });
+            if (possibleRoot !== zeroAddress) {
+                const possibleLinkedWallets = await readContract(viem, {
+                    address: walletLinkAddress,
+                    abi: walletLinkAbi,
+                    functionName: 'getWalletsByRootKey',
+                    args: [possibleRoot],
+                });
+                return [possibleRoot, ...possibleLinkedWallets];
+            }
+        }
+        return linkedWallets;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the deployed modular smart account for a userId (rootkey)
+ * This function:
+ * 1. Gets all linked wallets for the userId using the WalletLink contract
+ * 2. Checks each wallet to see if it has a deployed modular smart account
+ * 3. Returns the first modular smart account found, or null if none exist
+ *
+ * @param bot - The bot instance
+ * @param params - User id
+ * @returns The address of the deployed modular smart account, or null if none exists
+ *
+ * @example
+ * ```typescript
+ * import { getDeployedSmartAccount } from '@towns-labs/agent'
+ *
+ * // Simple usage with bot instance
+ * const address = await getDeployedSmartAccount(bot, userId)
+ * ```
+ */
+export async function getSmartAccountFromUserId(bot, params) {
+    const contractAddress = bot.client.config.base.chainConfig.addresses.spaceFactory;
+    return getSmartAccountFromUserIdImpl(contractAddress, bot.viem, params.userId);
+}
+export async function getSmartAccountFromUserIdImpl(contractAddress, viem, userId) {
+    try {
+        // Get all linked wallets for this user
+        const linkedWallets = await getLinkedWalletsWithRootKey(viem, userId, contractAddress);
+        // Check each wallet for a deployed modular smart account
+        for (const address of linkedWallets) {
+            const isModular = await checkSmartAccountImplementation(viem, address);
+            if (isModular) {
+                return address;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=smart-account.js.map

package/dist/smart-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-account.js","sourceRoot":"","sources":["../src/smart-account.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,67 @@
+{
+    "name": "@towns-labs/agent",
+    "version": "2.0.1",
+    "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": "^1.0.1",
+        "@towns-labs/generated": "^1.0.1",
+        "@towns-labs/proto": "^1.0.1",
+        "@towns-labs/sdk": "^1.0.1",
+        "@towns-labs/sdk-crypto": "^1.0.1",
+        "@towns-labs/utils": "^1.0.1",
+        "@towns-labs/web3": "^1.0.1",
+        "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.14.0",
+        "@towns-labs/contracts": "^2.0.0",
+        "@towns-labs/relayer-client": "^0.0.1",
+        "@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.29.3",
+        "vitest": "^3.2.3",
+        "zod": "^4.3.6"
+    },
+    "files": [
+        "/dist",
+        "package.json"
+    ],
+    "peerDependencies": {
+        "hono": ">=4",
+        "viem": "2.x"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}