Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Fix unit issues in balance/transfer actions - #835

Merged
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat
Sep 5, 2025
Merged

Fix unit issues in balance/transfer actions#835
CarsonRoscoe merged 6 commits into
coinbase:mainfrom
phdargen:fixBalanceFormat

Conversation

@phdargen

@phdargenphdargen commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Description

Fixes issues for native/erc20 balance actions reported by @Story91:

  • get_wallet_details returns ETH amount in wei, LLM converts this to whole units in message to user. Result of conversion depends on LLM knowledge, gpt-4o-mini always got it wrong in my tests
    -> get_wallet_details returns now both amount in wei and whole units

  • when several erc20 token balances are queried in one prompt, default rpc might throw error due to rate limits
    -> made rpc calls more efficient using multicall

  • when prompting eg "fetch usdc balance", LLM often hallucinates address (for example taking usdc address from mainnet, not base)
    -> refined action description + added new action to retrieve commonly used token addresses by symbol for given network

In addition, the following improvements are made:

  • WalletActionProvider native_transfer takes amount in whole units as input and passes this to walletProviders. However, most of them expect atomic units instead -> this is now handled consistently as follows: action takes whole unit format as input, converts to atomic units and then calls internal native_transfer from walletProviders with that
  • remove hardcoded erc20 abi in favor of viem export
  • added guardrails for erc20 transfers to prevent loss of funds by sending to token contracts
  • added optional address arg (default to wallet address) to get_balance erc20 action
  • fixed examples/langchain-cdp-chatbot /chatbot.ts to correctly configure CdpSolanaWalletProvider
  • fixed native sol transfers for CdpSolanaWalletProvider that was throwing Error during transfer: Error: Signature must be 64 bytes long

Tests

Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Base mainnet
Prompt: wallet info
-------------------
Wallet Details:
- Provider: cdp_evm_wallet_provider
- Address: 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- Network:
* Protocol Family: evm
* Network ID: base-mainnet
* Chain ID: 8453
- Native Balance: 411444858090719 WEI
- Native Balance: 0.000411444858090719 ETH
-------------------
Here are the details of your wallet:
- **Address:** 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21
- **Provider:** cdp_evm_wallet_provider
- **Network:**
- **Protocol Family:** EVM
- **Network ID:** base-mainnet
- **Chain ID:** 8453
- **Native Token Balance:** 0.000411444858090719 ETH
-------------------
Prompt: fetch usdc and cbbtc balance
-------------------
Token address for USDC on base-mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
-------------------
-------------------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0.231121
-------------------
Here are your balances for USDC and CBBTC:
- **USDC Balance:** 0.231121 USDC
- **CBBTC Balance:** 0.00000024 CBBTC
If you need any further assistance, let me know!
-------------------
Prompt: check bankr balance
-------------------
Error: Token symbol "BANKR" not found on base-mainnet. Available token symbols on base-mainnet: USDC, EURC, CBBTC, CBETH, WETH, ZORA, AERO, BNKR, CLANKER
-------------------
-------------------
Token address for BNKR on base-mainnet: 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b
-------------------
-------------------
Balance of BankrCoin (0x22af33fe49fd1fa80c7149773dde5890d3c76f3b) at address 0xf2d4580ADfe8E012f5550322706d62DF11fDBE21 is 0
-------------------
Your balance for BankrCoin (BNKR) is **0**. If you need assistance with anything else, feel free to ask!
-------------------
Prompt: send 0.001 usdc to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transferred 0.001 of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f.
Transaction hash for the transfer: 0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2
-------------------
I have successfully transferred **0.001 USDC** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**. The transaction hash is: **0xfc070337f72b5e154e556d007efc6418ff8c74bcc29c087107e07efdcc16daf2**.
If you need anything else, just let me know!
-------------------
Prompt: send 0.000001 eth to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
-------------------
Transferred 0.000001 ETH to 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
Transaction hash: 0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221
-------------------
I have successfully transferred **0.000001 ETH** to the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f**.
The transaction hash is: **0xeafcac9aa1beb05a2dd72362741939287b6b951ef70a96de38252d5270b08221**.
Prompt: check usdc balance for 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f
----------
Balance of USD Coin (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) at address 0xa8c1a5D3C372C65c04f91f87a43F549619A9483f is 9.076885
-------------------
The balance of USDC for the address **0xa8c1a5D3C372C65c04f91f87a43F549619A9483f** is **9.076885 USDC**.
Chatbot: typescript/examples/langchain-cdp-chatbot/chatbot.ts
Network: Solana devnet
Prompt: send 0.0001 sol to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U -------------------
Transferred 0.0001 SOL to 91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U
Signature: 45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM
-------------------
The transfer of 0.0001 SOL to the address **91sEBA6DLKakGV4raqW2pE8bmQR1D9dnbdGTjtATur5U** has been successfully completed. Transaction Signature: **45MJKkm5CEQbCED8s7Ykz8P8bFySyqXq8AoLWzXW2NXUMMWwW2hcUs22yux1M9q5RHvcUGvcVbgHyy3sHGVC6CyM**

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall

cb-heimdall commented Sep 4, 2025

Copy link
Copy Markdown

✅ Heimdall Review Status

RequirementStatusMore Info
Reviews2/1
Denominator calculation
Show calculation
1 if user is bot0
1 if user is external0
2 if repo is sensitive0
From .codeflow.yml1
Additional review requirements
Show calculation
Max0
0
From CODEOWNERS0
Global minimum0
Max 1
1
1 if commit is unverified0
Sum1

@phdargen
phdargen marked this pull request as draft September 4, 2025 03:39
@github-actionsgithub-actionsBot added action provider New action provider wallet provider New wallet provider typescript documentation Improvements or additions to documentation labels Sep 4, 2025
@phdargen
phdargen marked this pull request as ready for review September 4, 2025 04:20
@phdargen
phdargenforce-pushed the fixBalanceFormat branch 2 times, most recently from 532bc67 to c2857a8CompareSeptember 4, 2025 04:40
@github-actionsgithub-actionsBot added the example New example agent label Sep 4, 2025

@CarsonRoscoeCarsonRoscoe left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fantastic work, ty! Lots of little chores we've been meaning to get to all wrapped up in one nice package

@CarsonRoscoe
CarsonRoscoe merged commit 5e133ea into coinbase:mainSep 5, 2025
26 checks passed
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action providerNew action providerdocumentationImprovements or additions to documentationexampleNew example agenttypescriptwallet providerNew wallet provider

Development

Successfully merging this pull request may close these issues.

4 participants

@phdargen@cb-heimdall@CarsonRoscoe@murrlincoln