feat: implement swaps FROM NEAR and token balance fetching

- Add getUnsignedNearTransaction/getNearTransactionFees to NearIntentsSwapper
- Add execNearTransaction to TradeExecution class
- Update useTradeExecution hook to handle NEAR chain namespace
- Implement token balance fetching via nearblocks API in NearChainAdapter
- Add VITE_NEAR_NODE_URL and VITE_NEARBLOCKS_API_URL to environment
- Add nearblocks to CSP configuration
- Export NEAR CoinGecko adapter (fixes market data)
- Add GetNearTradeQuoteInput types to swapper types
- Update tests to include NEAR USDC

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: gomesalexandre

.env

@@ -159,6 +159,8 @@ VITE_THORCHAIN_NODE_URL=https://api.thorchain.shapeshift.com/lcd
 VITE_MAYACHAIN_NODE_URL=https://api.mayachain.shapeshift.com/lcd
 VITE_SOLANA_NODE_URL=https://api.solana.shapeshift.com/api/v1/jsonrpc
 VITE_TRON_NODE_URL=https://api.trongrid.io
+VITE_NEAR_NODE_URL=https://rpc.mainnet.near.org
+VITE_NEARBLOCKS_API_URL=https://api.nearblocks.io/v1
 VITE_ALCHEMY_POLYGON_URL=https://polygon-mainnet.g.alchemy.com/v2/anoTMcIc2hbPUxri37h4DeuUwg2p5_xZ
 
 # midgard

headers/csps/chains/near.ts

@@ -6,5 +6,5 @@ const mode = process.env.MODE ?? process.env.NODE_ENV ?? 'development'
 const env = loadEnv(mode, process.cwd(), '')
 
 export const csp: Csp = {
-  'connect-src': [env.VITE_NEAR_NODE_URL],
+  'connect-src': [env.VITE_NEAR_NODE_URL, env.VITE_NEARBLOCKS_API_URL],
 }

packages/caip/src/adapters/coingecko/generated/index.ts

@@ -21,6 +21,7 @@ import solana from './solana_5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/adapter.json'
 import sui from './sui_35834a8a/adapter.json'
 import tron from './tron_0x2b6653dc/adapter.json'
 import zcash from './bip122_00040fe8ec8471911baa1db1266ea15d/adapter.json'
+import near from './near_mainnet/adapter.json'
 
 export {
 	bitcoin,
@@ -45,5 +46,6 @@ export {
 	solana,
 	sui,
 	tron,
-	zcash
+	zcash,
+	near
 }

packages/caip/src/adapters/coingecko/index.test.ts

@@ -194,6 +194,12 @@ describe('adapters:coingecko', () => {
         assetNamespace: 'erc20',
         assetReference: '0xb88339cb7199b77e23db6e890353e22632ba630f',
       })
+      const usdcOnNear = toAssetId({
+        chainNamespace: CHAIN_NAMESPACE.Near,
+        chainReference: CHAIN_REFERENCE.NearMainnet,
+        assetNamespace: 'nep141',
+        assetReference: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1',
+      })
       expect(coingeckoToAssetIds('usd-coin')).toEqual([
         usdcOnEthereum,
         usdcOnAvalanche,
@@ -206,6 +212,7 @@ describe('adapters:coingecko', () => {
         usdcOnSolana,
         usdcOnSui,
         usdcOnTron,
+        usdcOnNear,
       ])
     })
     it('can get AssetIds for bridged USD Coin on EVM Chains', () => {

packages/chain-adapters/package.json

@@ -32,6 +32,7 @@
     "@mysten/sui": "1.45.0",
     "@near-js/crypto": "^2.5.1",
     "@near-js/transactions": "^2.5.1",
+    "@near-js/utils": "^2.5.1",
     "@shapeshiftoss/caip": "workspace:^",
     "@shapeshiftoss/hdwallet-core": "1.62.35-near-chain.1",
     "@shapeshiftoss/hdwallet-ledger": "1.62.35-near-chain.1",

packages/chain-adapters/src/near/NearChainAdapter.ts

@@ -5,13 +5,19 @@ import {
   Signature,
   SignedTransaction,
 } from '@near-js/transactions'
+import { baseDecode, baseEncode } from '@near-js/utils'
 import type { AssetId, ChainId } from '@shapeshiftoss/caip'
-import { ASSET_REFERENCE, nearAssetId, nearChainId } from '@shapeshiftoss/caip'
+import {
+  ASSET_NAMESPACE,
+  ASSET_REFERENCE,
+  nearAssetId,
+  nearChainId,
+  toAssetId,
+} from '@shapeshiftoss/caip'
 import type { HDWallet } from '@shapeshiftoss/hdwallet-core'
 import type { Bip44Params, RootBip44Params } from '@shapeshiftoss/types'
 import { KnownChainIds } from '@shapeshiftoss/types'
 import { TransferType, TxStatus } from '@shapeshiftoss/unchained-client'
-import bs58 from 'bs58'
 
 import type { ChainAdapter as IChainAdapter } from '../api'
 import { ChainAdapterError, ErrorHandler } from '../error/ErrorHandler'
@@ -41,6 +47,25 @@ interface NearWallet extends HDWallet {
   }): Promise<{ signature: string; publicKey: string } | null>
 }
 
+interface NearBlocksFtMeta {
+  name: string
+  symbol: string
+  decimals: number
+  icon: string | null
+  reference: string | null
+  price: string | null
+}
+
+interface NearBlocksFtBalance {
+  contract: string
+  amount: string
+  ft_meta: NearBlocksFtMeta
+}
+
+interface NearBlocksInventoryResponse {
+  fts: NearBlocksFtBalance[]
+}
+
 const supportsNear = (wallet: HDWallet): wallet is NearWallet => {
   return '_supportsNear' in wallet && (wallet as any)._supportsNear === true
 }
@@ -139,6 +164,8 @@ interface NearFullTxResult {
   }[]
 }
 
+const NEARBLOCKS_API_URL = 'https://api.nearblocks.io/v1'
+
 export class ChainAdapter implements IChainAdapter<KnownChainIds.NearMainnet> {
   static readonly rootBip44Params: RootBip44Params = {
     purpose: 44,
@@ -244,21 +271,60 @@ export class ChainAdapter implements IChainAdapter<KnownChainIds.NearMainnet> {
     }
   }
 
+  private async fetchTokenBalances(accountId: string): Promise<
+    {
+      assetId: AssetId
+      balance: string
+      name: string
+      precision: number
+      symbol: string
+    }[]
+  > {
+    try {
+      const response = await fetch(`${NEARBLOCKS_API_URL}/account/${accountId}/inventory`)
+      if (!response.ok) {
+        console.warn(`Failed to fetch NEAR token balances: ${response.status}`)
+        return []
+      }
+
+      const data = (await response.json()) as { inventory: NearBlocksInventoryResponse }
+      const fts = data.inventory?.fts ?? []
+
+      return fts.map(ft => ({
+        assetId: toAssetId({
+          chainId: this.chainId,
+          assetNamespace: ASSET_NAMESPACE.nep141,
+          assetReference: ft.contract,
+        }),
+        balance: ft.amount,
+        name: ft.ft_meta.name,
+        precision: ft.ft_meta.decimals,
+        symbol: ft.ft_meta.symbol,
+      }))
+    } catch (err) {
+      console.warn('Failed to fetch NEAR token balances:', err)
+      return []
+    }
+  }
+
   async getAccount(pubkey: string): Promise<Account<KnownChainIds.NearMainnet>> {
     try {
-      const accountResult = await this.rpcCall<NearAccountResult>('query', {
-        request_type: 'view_account',
-        finality: 'final',
-        account_id: pubkey,
-      })
+      const [accountResult, tokens] = await Promise.all([
+        this.rpcCall<NearAccountResult>('query', {
+          request_type: 'view_account',
+          finality: 'final',
+          account_id: pubkey,
+        }),
+        this.fetchTokenBalances(pubkey),
+      ])
 
       return {
         balance: accountResult.amount,
         chainId: this.chainId,
         assetId: this.assetId,
         chain: this.getType(),
         chainSpecific: {
-          tokens: [],
+          tokens,
         },
         pubkey,
       }
@@ -311,7 +377,7 @@ export class ChainAdapter implements IChainAdapter<KnownChainIds.NearMainnet> {
 
       // Convert hex public key to bytes and create PublicKey using standard NEAR format
       const pubKeyBytes = Buffer.from(from, 'hex')
-      const pubKeyBase58 = bs58.encode(pubKeyBytes)
+      const pubKeyBase58 = baseEncode(pubKeyBytes)
       const publicKey = PublicKey.fromString(`ed25519:${pubKeyBase58}`)
 
       // Get current nonce from access key
@@ -330,7 +396,7 @@ export class ChainAdapter implements IChainAdapter<KnownChainIds.NearMainnet> {
         [],
       )
       const blockHashBase58 = statusResult.sync_info.latest_block_hash
-      const blockHash = bs58.decode(blockHashBase58)
+      const blockHash = baseDecode(blockHashBase58)
 
       // Build transfer action
       const actions = [actionCreators.transfer(BigInt(value))]

packages/swapper/src/swappers/ButterSwap/swapperApi/getTradeQuote.test.ts

@@ -40,6 +40,7 @@ describe('getTradeQuote', () => {
       assertGetSolanaChainAdapter: () => vi.fn() as any,
       assertGetTronChainAdapter: () => vi.fn() as any,
       assertGetSuiChainAdapter: () => vi.fn() as any,
+      assertGetNearChainAdapter: () => vi.fn() as any,
       config: {
         VITE_BUTTERSWAP_CLIENT_ID: 'test',
       } as any,

packages/swapper/src/swappers/ButterSwap/swapperApi/getTradeRate.test.ts

@@ -29,6 +29,7 @@ describe('getTradeRate', () => {
       assertGetSolanaChainAdapter: () => vi.fn() as any,
       assertGetTronChainAdapter: () => vi.fn() as any,
       assertGetSuiChainAdapter: () => vi.fn() as any,
+      assertGetNearChainAdapter: () => vi.fn() as any,
       config: {
         VITE_BUTTERSWAP_CLIENT_ID: 'test',
       } as any,
@@ -70,6 +71,7 @@ describe('getTradeRate', () => {
       assertGetSolanaChainAdapter: () => vi.fn() as any,
       assertGetTronChainAdapter: () => vi.fn() as any,
       assertGetSuiChainAdapter: () => vi.fn() as any,
+      assertGetNearChainAdapter: () => vi.fn() as any,
       config: {
         VITE_BUTTERSWAP_CLIENT_ID: 'test',
       } as any,

packages/swapper/src/swappers/NearIntentsSwapper/NearIntentsSwapper.ts

@@ -1,6 +1,7 @@
 import type { Swapper } from '../../types'
 import {
   executeEvmTransaction,
+  executeNearTransaction,
   executeSolanaTransaction,
   executeSuiTransaction,
   executeTronTransaction,
@@ -11,6 +12,7 @@ export const nearIntentsSwapper: Swapper = {
   executeSolanaTransaction,
   executeTronTransaction,
   executeSuiTransaction,
+  executeNearTransaction,
   executeUtxoTransaction: (txToSign, { signAndBroadcastTransaction }) => {
     return signAndBroadcastTransaction(txToSign)
   },

packages/swapper/src/swappers/NearIntentsSwapper/endpoints.ts

@@ -246,6 +246,32 @@ export const nearIntentsApi: SwapperApi = {
     return Promise.resolve(step.feeData.networkFeeCryptoBaseUnit)
   },
 
+  getUnsignedNearTransaction: async ({
+    stepIndex,
+    tradeQuote,
+    from,
+    assertGetNearChainAdapter,
+  }: GetUnsignedNearTransactionArgs) => {
+    if (!isExecutableTradeQuote(tradeQuote)) throw new Error('Unable to execute a trade rate quote')
+
+    const step = getExecutableTradeStep(tradeQuote, stepIndex)
+
+    const { accountNumber, sellAsset, nearIntentsSpecific } = step
+    if (!nearIntentsSpecific) throw new Error('nearIntentsSpecific is required')
+
+    const adapter = assertGetNearChainAdapter(sellAsset.chainId)
+
+    const to = nearIntentsSpecific.depositAddress
+    const value = step.sellAmountIncludingProtocolFeesCryptoBaseUnit
+
+    return await adapter.buildSendApiTransaction({
+      to,
+      from,
+      value,
+      accountNumber,
+    })
+  },
+
   getNearTransactionFees: ({ tradeQuote, stepIndex }: GetUnsignedNearTransactionArgs) => {
     if (!isExecutableTradeQuote(tradeQuote)) throw new Error('Unable to execute a trade rate quote')