feat: refactor npm to pnpm

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",

.github/workflows/format.yml

@@ -40,13 +40,17 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure formatting
  working-directory: ./typescript
  run: |
-npm ci
-npm run format:check
+pnpm install --frozen-lockfile
+pnpm run format:check

.github/workflows/lint.yml

@@ -52,35 +52,44 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
  - name: Ensure Linting
  working-directory: ./typescript
  run: |
-npm ci
-npm run lint
+pnpm install --frozen-lockfile
+pnpm run lint
 
  check-package-lock:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@v4
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
- - name: Check if package-lock.json changed
+ - name: Check if pnpm-lock.yaml changed
  working-directory: ./typescript
  run: |
-npm install
- if [ -n "$(git diff package-lock.json)" ]; then
- echo "Error: package-lock.json was modified after running npm install. Please commit the updated package-lock.json file."
- git diff package-lock.json
+pnpm install
+ if [ -n "$(git diff pnpm-lock.yaml)" ]; then
+ echo "Error: pnpm-lock.yaml was modified after running pnpm install. Please commit the updated pnpm-lock.yaml file."
+ git diff pnpm-lock.yaml
  exit 1
  fi
 

.github/workflows/publish_docs.yml

@@ -9,19 +9,23 @@ jobs:
  steps:
  - uses: actions/checkout@v3
 
- - name: Set up Node 18
- uses: actions/setup-node@v4
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
+ - uses: actions/setup-node@v4
  with:
  node-version: "18"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install and Build JSDocs
  working-directory: ./typescript
  run: |
-npm ci
-npm run build
-npm run docs
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm run docs
 
  - name: Build AgentKit JSDocs
  run: |

.github/workflows/publish_nightly.yml

@@ -35,11 +35,16 @@ jobs:
  with:
  ref: nightly
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install jq
@@ -48,8 +53,8 @@ jobs:
  - name: Install dependencies and build packages
  run: |
  cd typescript
-npm ci
-npm run build
+pnpm install --frozen-lockfile
+pnpm run build
 
  - name: Find NPM packages
  id: find-npm-packages
@@ -76,11 +81,11 @@ jobs:
  LATEST_NIGHTLY=$(echo "$ALL_VERSIONS" | jq -r '.[]' 2>/dev/null | grep -E "nightly\.[0-9]{8}\.[0-9]+$" | sort -V | tail -n1 || echo "")
  TODAY=$(date +%Y%m%d)
  if [ -z "$LATEST_NIGHTLY" ]; then
-npm version prerelease --preid=nightly.$TODAY --no-git-tag-version
+pnpm version prerelease --preid=nightly.$TODAY --no-git-tag-version
  else
  BUILD_NUM=$(echo $LATEST_NIGHTLY | grep -Eo '[0-9]+$')
  NEXT_BUILD=$((BUILD_NUM + 1))
-npm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
+pnpm version "$(echo $LATEST_NIGHTLY | cut -d'-' -f1)-nightly.$TODAY.$NEXT_BUILD" --no-git-tag-version
  fi
  fi
  cd - > /dev/null
@@ -92,7 +97,7 @@ jobs:
  cd typescript
  for pkg in ${{ steps.find-npm-packages.outputs.packages }}; do
  if [ -f "$pkg/package.json" ] && ! grep -q '"private": true' "$pkg/package.json"; then
- cd $pkg && npm publish --tag nightly --provenance --access public
+ cd $pkg && pnpm publish --tag nightly --provenance --access public
  cd - > /dev/null
  fi
  done

.github/workflows/publish_npm_manual.yml

@@ -18,17 +18,24 @@ jobs:
  id-token: write
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install, build and publish package
  working-directory: ./typescript/${{ inputs.directory }}
  run: |
-npm ci
-npm run build
-npm publish --provenance --access public
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm publish --provenance --access public
  env:
  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/unit_tests.yml

@@ -47,13 +47,20 @@ jobs:
  node-version: ["18", "20"]
  steps:
  - uses: actions/checkout@v4
+
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - uses: actions/setup-node@v4
  with:
  node-version: ${{ matrix.node-version }}
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
+
  - name: Install and test AgentKit.js
  working-directory: ./typescript
  run: |
-npm ci
-npm run test
+pnpm install --frozen-lockfile
+pnpm run test

.github/workflows/version_publish_npm.yml

@@ -17,25 +17,30 @@ jobs:
  - name: Clone repository
  uses: actions/checkout@v4
 
+ - name: Setup pnpm
+ uses: pnpm/action-setup@a7487c7e89a18df4991f7f222e4898a00d66ddda
+ with:
+ version: 10
+
  - name: Setup Node
  uses: actions/setup-node@v4
  with:
  node-version: "18"
  registry-url: "https://registry.npmjs.org"
- cache: "npm"
+ cache: "pnpm"
  cache-dependency-path: ./typescript
 
  - name: Install dependencies
- run: npm ci
+ run: pnpm install --frozen-lockfile
  working-directory: ./typescript
 
  - name: Version and/or Publish to NPM
  uses: changesets/action@06245a4e0a36c064a573d4150030f5ec548e4fcc
  with:
  commit: "chore: version typescript packages"
  title: "chore: version typescript packages"
- version: npm run changeset:version
- publish: npm run publish
+ version: pnpm run changeset:version
+ publish: pnpm run publish
  cwd: ./typescript
  env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -134,4 +134,8 @@ docs/
 !python/coinbase-agentkit/docs/
 !python/framework-extensions/langchain/docs/
 
-.to-publish-pypi
+.to-publish-pypi
+
+# pnpm
+typescript/.pnpm-store
+typescript/.pnp.*

CONTRIBUTING-TYPESCRIPT.md

@@ -15,18 +15,23 @@ This guide covers TypeScript-specific setup and development for AgentKit.
 
 ## Development Setup
 
-AgentKit uses Node.js v18.x or higher and npm 8.x or higher.
+AgentKit uses Node.js v18.x or higher and pnpm 10.7.x or higher.
 
-You can run the following commands in your terminal to check your local Node.js and npm versions:
+You can run the following commands in your terminal to check your local Node.js and pnpm versions:
 
 ```bash
 node --version
-npm --version
+pnpm --version
 ```
 
-If the versions are not correct or you don't have Node.js or npm installed, download through [nvm](https://github.com/nvm-sh/nvm).
+If the versions are not correct or you don't have Node.js or pnpm installed, download Node.Js through [fnm](https://github.com/Schniz/fnm) and then install [pnpm](https://pnpm.io/installation).
 
-Once you have these installed, make sure you install the project dependencies by running `npm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+Once you have these installed, make sure you install the project dependencies by running `pnpm install` from the root of the TypeScript monorepo, in other words, from the root `typescript/` folder.
+
+> **Note for existing contributors**: If you previously contributed when this was an npm turbo monorepo, you'll need to remove existing node_modules directories and reinstall dependencies with pnpm. From the `typescript/` directory, run:
+> ```bash
+> find . -name "node_modules" -type d -exec rm -rf {} + && pnpm i
+> ```
 
 ## Adding an Action Provider
 
@@ -184,7 +189,7 @@ You can then run the unit tests with the following command:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 Check out the [Testing](#testing) section to learn how to manually test your new action provider.
@@ -224,23 +229,23 @@ A good way to test new actions locally is by using the chatbot example in `types
 The flow is:
 
 1. Make your change as described in the [Adding an Agentic Action](#adding-an-agentic-action) section
-2. From `typescript/`, run `npm run build && npm i`
-3. In `typescript/examples/langchain-cdp-chatbot`, run `npm run start`
+2. From `typescript/`, run `pnpm run build && pnpm i`
+3. In `typescript/examples/langchain-cdp-chatbot`, run `pnpm run start`
 4. You can now interact with your new action via the chatbot!
 
 ### Running Tests
 
 From the package you are working in, you can run:
 
 ```bash
-npm test
+pnpm test
 ```
 
 For example, to run all tests in the `@coinbase/agentkit` package, you can run:
 
 ```bash
 cd typescript/agentkit
-npm test
+pnpm test
 ```
 
 ## Code Style
@@ -249,13 +254,13 @@ We use ESLint and Prettier for linting and formatting. Run:
 
 ```bash
 # Format code
-npm run format
+pnpm run format
 
 # Lint code
-npm run lint
+pnpm run lint
 
 # Fix linting issues
-npm run lint:fix
+pnpm run lint:fix
 ```
 
 ## Documentation
@@ -276,7 +281,7 @@ Changesets are stored in the `.changeset` directory. Each changeset is stored as
 To add a changeset, use `changesets` to create it for you:
 
 ```bash
-npm run changeset
+pnpm run changeset
 ```
 
 This will kick off an interactive prompt to help you create the changeset. Use the arrow keys to navigate the different options, and press the `Space` key to select an option. You should select the package(s) you are making a change to – most of the time this will be `@coinbase/agentkit`. Once selected, hit `Enter`. You'll then be prompted to specify the type of change you are making (major, minor or patch), starting with major. Most of the time you will not be making a major change, so hitting `Enter` will progress to the next step. If you're adding a new feature, you should select `minor`. If you're fixing a bug, you should select `patch`. Once selected, you will be prompted to provide a summary of your changes. This should be a short, specific description in the past tense (see above for examples).

typescript/agentkit/package.json

@@ -17,9 +17,8 @@
  "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
  "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
  "check": "tsc --noEmit",
- "test": "npx jest --no-cache --testMatch='**/*.test.ts'",
- "test:dry-run": "npm install && npm ci && npm publish --dry-run",
- "test:e2e": "npx jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
+ "test": "jest --no-cache --testMatch='**/*.test.ts'",
+ "test:e2e": "jest --no-cache --testMatch=**/e2e.ts --coverageThreshold '{}'",
  "test:types": "tsd --files src/tests/types.test-d.ts",
  "clean": "rm -rf dist/*",
  "prepack": "tsc",
@@ -47,6 +46,9 @@
  "@privy-io/server-auth": "^1.18.4",
  "@solana/spl-token": "^0.4.12",
  "@solana/web3.js": "^1.98.0",
+ "bs58": "^4.0.1",
+ "decimal.js": "^10.5.0",
+ "ethers": "^6.13.5",
  "md5": "^2.3.0",
  "opensea-js": "^7.1.18",
  "reflect-metadata": "^0.2.2",
@@ -60,6 +62,7 @@
  "@types/ora": "^3.2.0",
  "@types/prompts": "^2.4.9",
  "@types/secp256k1": "^4.0.6",
+ "abitype": "^1.0.8",
  "http-server": "^14.1.1",
  "jest": "^29.7.0",
  "mock-fs": "^5.2.0",