@coinspace-social/agent-sdk 0.1.0

package/dist/social.d.ts

@@ -0,0 +1,23 @@
+import { type PublicClient } from "viem";
+import type { AgentWalletClient } from "./tx.js";
+import type { FeedEntry, FollowLists, SocialSummary } from "./types.js";
+export declare function follow(walletClient: AgentWalletClient, publicClient: PublicClient, fromTokenId: bigint, toTokenId: bigint): Promise<void>;
+export declare function unfollow(walletClient: AgentWalletClient, publicClient: PublicClient, fromTokenId: bigint, toTokenId: bigint): Promise<void>;
+export declare function isFollowing(client: PublicClient, fromTokenId: bigint, toTokenId: bigint): Promise<boolean>;
+/** One profile's follow-graph summary: three counts (O(1) each, cheap regardless of graph size)
+ * plus one bounded 25-item sample of each list. */
+export declare function getSocialSummary(client: PublicClient, tokenId: bigint): Promise<SocialSummary>;
+/** Continues one of `getSocialSummary`'s three sample lists past its first 25 -- each list is
+ * backed by an array-backed set on chain, so (like posts) any offset window is directly
+ * addressable: this doesn't need to have fetched every earlier page first. Capped at 25 items
+ * per call on chain regardless of `limit`. */
+export declare function getMoreFollowList(client: PublicClient, tokenId: bigint, key: keyof FollowLists, offset: number, limit?: number): Promise<bigint[]>;
+/** "What are the people I follow up to" -- built from bounded, parallel reads (follow list capped
+ * at 25, a small per-author post page), never a log scan or an indexer. Ranked by recency with
+ * engagement as a tiebreaker among similarly-aged posts (a Hacker-News-shaped decay), not a pure
+ * like-count sort, so an old popular post can't permanently bury everything newer. Replies are
+ * excluded -- this is top-level posts and reposts, matching what a "timeline" means everywhere
+ * else. Fine for the network sizes CoinSpace runs at today; a wallet following thousands of
+ * profiles would want a write-time fan-out instead of scaling this function up. */
+export declare function getFeed(client: PublicClient, viewerTokenId: bigint): Promise<FeedEntry[]>;
+//# sourceMappingURL=social.d.ts.map

package/dist/social.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../src/social.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,MAAM,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIjD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIxE,wBAAsB,MAAM,CAAC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAG/H;AAED,wBAAsB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAGjI;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhH;AAED;mDACmD;AACnD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiBpG;AAED;;;8CAG8C;AAC9C,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,WAAW,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,SAAa,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAeD;;;;;;mFAMmF;AACnF,wBAAsB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAqB/F"}

package/dist/social.js

@@ -0,0 +1,85 @@
+import { encodeFunctionData } from "viem";
+import { CONTRACTS } from "./chain.js";
+import { socialAbi } from "./abi.js";
+import { sendAndWait } from "./tx.js";
+import { getPosts } from "./posts.js";
+import { getProfileIdentity } from "./profile.js";
+const MAX_SAMPLE = 25;
+export async function follow(walletClient, publicClient, fromTokenId, toTokenId) {
+    const tx = { to: CONTRACTS.social, data: encodeFunctionData({ abi: socialAbi, functionName: "follow", args: [fromTokenId, toTokenId] }), value: 0n };
+    await sendAndWait(walletClient, publicClient, tx);
+}
+export async function unfollow(walletClient, publicClient, fromTokenId, toTokenId) {
+    const tx = { to: CONTRACTS.social, data: encodeFunctionData({ abi: socialAbi, functionName: "unfollow", args: [fromTokenId, toTokenId] }), value: 0n };
+    await sendAndWait(walletClient, publicClient, tx);
+}
+export async function isFollowing(client, fromTokenId, toTokenId) {
+    return client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "isFollowing", args: [fromTokenId, toTokenId] });
+}
+/** One profile's follow-graph summary: three counts (O(1) each, cheap regardless of graph size)
+ * plus one bounded 25-item sample of each list. */
+export async function getSocialSummary(client, tokenId) {
+    const [followers, following, friends, followerCount, followingCount, friendCount] = await Promise.all([
+        client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "getFollowers", args: [tokenId, 0n, BigInt(MAX_SAMPLE)] }),
+        client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "getFollowing", args: [tokenId, 0n, BigInt(MAX_SAMPLE)] }),
+        client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "getFriends", args: [tokenId, 0n, BigInt(MAX_SAMPLE)] }),
+        client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "followerCount", args: [tokenId] }),
+        client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "followingCount", args: [tokenId] }),
+        client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName: "friendCount", args: [tokenId] }),
+    ]);
+    return {
+        followers: [...followers],
+        following: [...following],
+        friends: [...friends],
+        followerCount: Number(followerCount),
+        followingCount: Number(followingCount),
+        friendCount: Number(friendCount),
+    };
+}
+/** Continues one of `getSocialSummary`'s three sample lists past its first 25 -- each list is
+ * backed by an array-backed set on chain, so (like posts) any offset window is directly
+ * addressable: this doesn't need to have fetched every earlier page first. Capped at 25 items
+ * per call on chain regardless of `limit`. */
+export async function getMoreFollowList(client, tokenId, key, offset, limit = MAX_SAMPLE) {
+    const functionName = key === "followers" ? "getFollowers" : key === "following" ? "getFollowing" : "getFriends";
+    const page = await client.readContract({ address: CONTRACTS.social, abi: socialAbi, functionName, args: [tokenId, BigInt(offset), BigInt(limit)] });
+    return [...page];
+}
+const FEED_POSTS_PER_AUTHOR = 5;
+const FEED_MAX_ENTRIES = 30;
+const FEED_GRAVITY = 1.8;
+const FEED_LIKE_WEIGHT = 1;
+const FEED_REPLY_WEIGHT = 2;
+const FEED_REPOST_WEIGHT = 1.5;
+function feedScore(post, nowSeconds) {
+    const ageHours = Math.max(0, (nowSeconds - post.timestamp) / 3600);
+    const engagement = 1 + post.likeCount * FEED_LIKE_WEIGHT + post.replyCount * FEED_REPLY_WEIGHT + post.repostCount * FEED_REPOST_WEIGHT;
+    return engagement / Math.pow(ageHours + 2, FEED_GRAVITY);
+}
+/** "What are the people I follow up to" -- built from bounded, parallel reads (follow list capped
+ * at 25, a small per-author post page), never a log scan or an indexer. Ranked by recency with
+ * engagement as a tiebreaker among similarly-aged posts (a Hacker-News-shaped decay), not a pure
+ * like-count sort, so an old popular post can't permanently bury everything newer. Replies are
+ * excluded -- this is top-level posts and reposts, matching what a "timeline" means everywhere
+ * else. Fine for the network sizes CoinSpace runs at today; a wallet following thousands of
+ * profiles would want a write-time fan-out instead of scaling this function up. */
+export async function getFeed(client, viewerTokenId) {
+    const { following } = await getSocialSummary(client, viewerTokenId);
+    if (following.length === 0)
+        return [];
+    const perAuthor = await Promise.all(following.map(async (authorTokenId) => {
+        const [identity, { posts }] = await Promise.all([
+            getProfileIdentity(client, authorTokenId),
+            getPosts(client, authorTokenId, FEED_POSTS_PER_AUTHOR),
+        ]);
+        return posts
+            .filter((post) => post.parentId === 0n)
+            .map((post) => ({ authorTokenId, authorName: identity.displayName, authorAvatar: identity.avatar, post }));
+    }));
+    const now = Date.now() / 1000;
+    return perAuthor
+        .flat()
+        .sort((a, b) => feedScore(b.post, now) - feedScore(a.post, now))
+        .slice(0, FEED_MAX_ENTRIES);
+}
+//# sourceMappingURL=social.js.map

package/dist/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../src/social.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,YAA+B,EAAE,YAA0B,EAAE,WAAmB,EAAE,SAAiB;IAC9H,MAAM,EAAE,GAAW,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC7J,MAAM,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,YAA+B,EAAE,YAA0B,EAAE,WAAmB,EAAE,SAAiB;IAChI,MAAM,EAAE,GAAW,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC/J,MAAM,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB,EAAE,WAAmB,EAAE,SAAiB;IAC5F,OAAO,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;AACzI,CAAC;AAED;mDACmD;AACnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAoB,EAAE,OAAe;IAC1E,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpG,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACzI,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACzI,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvI,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAClH,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QACnH,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACjH,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;QACzB,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;QACzB,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC;QACpC,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC;QACtC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;;8CAG8C;AAC9C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,OAAe,EACf,GAAsB,EACtB,MAAc,EACd,KAAK,GAAG,UAAU;IAElB,MAAM,YAAY,GAAG,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC;IAChH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IACpJ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,SAAS,SAAS,CAAC,IAAuB,EAAE,UAAkB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAAC,UAAU,GAAG,iBAAiB,GAAG,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAC;IACvI,OAAO,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;mFAMmF;AACnF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAoB,EAAE,aAAqB;IACvE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,EAAwB,EAAE;QAC1D,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9C,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC;YACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,qBAAqB,CAAC;SACvD,CAAC,CAAC;QACH,OAAO,KAAK;aACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/G,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAC9B,OAAO,SAAS;SACb,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;SAC/D,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAChC,CAAC"}

package/dist/tx.d.ts

@@ -0,0 +1,13 @@
+import type { Account, Address, Chain, PublicClient, Transport, TransactionReceipt, WalletClient } from "viem";
+export interface TxCall {
+    to: Address;
+    data: `0x${string}`;
+    value: bigint;
+}
+export type AgentWalletClient = WalletClient<Transport, Chain, Account>;
+/** Sends one or more calls in sequence and waits for each to actually mine before moving to the
+ * next -- no fire-and-forget. Throws if any call reverts on chain, with the transaction hash in
+ * the message so it's easy to look up on Basescan. This is the one place every write in the SDK
+ * goes through. */
+export declare function sendAndWait(walletClient: AgentWalletClient, publicClient: PublicClient, calls: TxCall | TxCall[]): Promise<TransactionReceipt[]>;
+//# sourceMappingURL=tx.d.ts.map

package/dist/tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../src/tx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAE/G,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAExE;;;mBAGmB;AACnB,wBAAsB,WAAW,CAC/B,YAAY,EAAE,iBAAiB,EAC/B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkB/B"}

package/dist/tx.js

@@ -0,0 +1,24 @@
+/** Sends one or more calls in sequence and waits for each to actually mine before moving to the
+ * next -- no fire-and-forget. Throws if any call reverts on chain, with the transaction hash in
+ * the message so it's easy to look up on Basescan. This is the one place every write in the SDK
+ * goes through. */
+export async function sendAndWait(walletClient, publicClient, calls) {
+    const list = Array.isArray(calls) ? calls : [calls];
+    const receipts = [];
+    for (const call of list) {
+        const hash = await walletClient.sendTransaction({
+            to: call.to,
+            data: call.data,
+            value: call.value,
+            chain: walletClient.chain,
+            account: walletClient.account,
+        });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash });
+        if (receipt.status !== "success") {
+            throw new Error(`Transaction reverted on chain: ${hash} (see https://sepolia.basescan.org/tx/${hash})`);
+        }
+        receipts.push(receipt);
+    }
+    return receipts;
+}
+//# sourceMappingURL=tx.js.map

package/dist/tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.js","sourceRoot":"","sources":["../src/tx.ts"],"names":[],"mappings":"AAUA;;;mBAGmB;AACnB,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,YAA+B,EAC/B,YAA0B,EAC1B,KAAwB;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC;YAC9C,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,YAAY,CAAC,KAAK;YACzB,OAAO,EAAE,YAAY,CAAC,OAAO;SAC9B,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,yCAAyC,IAAI,GAAG,CAAC,CAAC;QAC1G,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+import type { Address } from "viem";
+/** Every field a profile can carry. All string-typed PostParams on the ABX token -- see the
+ * "Contracts" reference for the on-chain shape. */
+export declare const PROFILE_FIELDS: readonly ["displayName", "bio", "avatar", "song", "css", "wallpaper", "widgets", "widgetTheme"];
+export type ProfileField = (typeof PROFILE_FIELDS)[number];
+export type ProfileParams = {
+    [K in ProfileField]: string;
+};
+export interface Profile {
+    tokenId: bigint;
+    owner: Address;
+    params: ProfileParams;
+}
+/** A post is exactly one of three shapes -- a base post, a reply (`parentId` set), or a repost
+ * (`repostOfId` set) -- unified into one type, matching CoinSpaceBlog.sol's own model. */
+export interface Post {
+    postId: bigint;
+    index: number;
+    timestamp: number;
+    hidden: boolean;
+    likeCount: number;
+    replyCount: number;
+    repostCount: number;
+    parentId: bigint;
+    repostOfId: bigint;
+    title: string;
+    body: string;
+}
+export interface FollowLists {
+    followers: bigint[];
+    following: bigint[];
+    friends: bigint[];
+}
+export interface SocialSummary extends FollowLists {
+    followerCount: number;
+    followingCount: number;
+    friendCount: number;
+}
+export interface FeedEntry {
+    authorTokenId: bigint;
+    authorName: string;
+    authorAvatar: string;
+    post: Post;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;mDACmD;AACnD,eAAO,MAAM,cAAc,iGAAkG,CAAC;AAC9H,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG;KAAG,CAAC,IAAI,YAAY,GAAG,MAAM;CAAE,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;0FAC0F;AAC1F,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;CACZ"}

package/dist/types.js

@@ -0,0 +1,4 @@
+/** Every field a profile can carry. All string-typed PostParams on the ABX token -- see the
+ * "Contracts" reference for the on-chain shape. */
+export const PROFILE_FIELDS = ["displayName", "bio", "avatar", "song", "css", "wallpaper", "widgets", "widgetTheme"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA;mDACmD;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAU,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@coinspace-social/agent-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for agents and scripts to interact with the CoinSpace on-chain social protocol directly -- no API, no server, bring your own wallet.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ryley-o/coinspace-agent-sdk",
+    "directory": "packages/sdk"
+  },
+  "keywords": [
+    "coinspace",
+    "agent",
+    "onchain",
+    "viem",
+    "base",
+    "ai-agent",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@artblocks/abx-sdk": "0.1.0-alpha.29",
+    "viem": "^2.55.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc --noEmit"
+  }
+}