Merge pull request #13 from macalinao/igm/metaplex-codama

Add Codama CLI and Metaplex Token Metadata program client

Author: macalinao

biome.json

@@ -72,7 +72,8 @@
     "includes": [
       "**",
       "!**/bun.lock",
-      "!apps/example-dapp/src/routeTree.gen.ts"
+      "!apps/example-dapp/src/routeTree.gen.ts",
+      "!packages/clients/*/src/generated/**"
     ]
   },
   "assist": {

bun.lock

@@ -7,6 +7,8 @@
   "workspaces": {
     "packages": [
       "packages/*",
+      "packages/codama/*",
+      "packages/clients/*",
       "apps/*"
     ],
     "catalog": {
@@ -28,8 +30,9 @@
   },
   "scripts": {
     "build": "turbo build",
+    "build:packages": "turbo build --filter='./packages/**'",
     "build:watch": "turbo watch build",
-    "build:watch:packages": "turbo watch build --filter='./packages/*'",
+    "build:watch:packages": "turbo watch build --filter='./packages/**'",
     "lint": "biome check && turbo run lint",
     "lint:fix": "biome check --write --no-errors-on-unmatched --unsafe && turbo run lint -- --fix",
     "clean": "turbo run clean",

package.json

@@ -0,0 +1,37 @@
+# @macalinao/token-metadata-client
+
+TypeScript client for the Metaplex Token Metadata program, generated using Codama with full ESM support.
+
+## Installation
+
+```bash
+bun add @macalinao/token-metadata-client
+```
+
+## Development
+
+This client is generated from the Token Metadata IDL using Codama CLI:
+
+```bash
+# Generate the client from idls/token_metadata.json
+bun run codegen
+
+# Build the TypeScript
+bun run build
+```
+
+### Configuration
+
+The `codama.config.mjs` file adds custom PDAs to the generated client, including the standard metadata PDA derivation.
+
+## Usage
+
+```typescript
+import { /* generated exports */ } from "@macalinao/token-metadata-client";
+
+// Use the generated client functions
+```
+
+## License
+
+Apache-2.0

packages/clients/token-metadata-client/README.md

@@ -0,0 +1,32 @@
+import { defineConfig } from "@macalinao/codama-cli";
+import {
+  addPdasVisitor,
+  constantPdaSeedNodeFromString,
+  publicKeyTypeNode,
+  variablePdaSeedNode,
+} from "codama";
+
+const addCustomPDAsVisitor = addPdasVisitor({
+  tokenMetadata: [
+    {
+      name: "metadata",
+      seeds: [
+        constantPdaSeedNodeFromString("utf8", "metadata"),
+        variablePdaSeedNode(
+          "programId",
+          publicKeyTypeNode(),
+          "The address of the program",
+        ),
+        variablePdaSeedNode(
+          "mint",
+          publicKeyTypeNode(),
+          "The address of the mint account",
+        ),
+      ],
+    },
+  ],
+});
+
+export default defineConfig({
+  visitors: [addCustomPDAsVisitor],
+});

packages/clients/token-metadata-client/codama.config.mjs

@@ -0,0 +1,31 @@
+import { configs } from "@macalinao/eslint-config";
+
+export default [
+  ...configs.fast,
+  {
+    languageOptions: {
+      parserOptions: {
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    files: ["src/generated/**/*.ts"],
+    rules: {
+      "@typescript-eslint/no-non-null-assertion": "off",
+      "@typescript-eslint/prefer-nullish-coalescing": "off",
+    },
+  },
+  {
+    files: [
+      "src/generated/instructions/*.ts",
+      "src/generated/types/*.ts",
+      "src/generated/errors/*.ts",
+    ],
+    rules: {
+      "@typescript-eslint/no-unnecessary-condition": "off",
+      "no-constant-condition": "off",
+      "@typescript-eslint/no-empty-object-type": "off",
+    },
+  },
+];