자율 온체인 에이전트 구축을 위한 최고의 블록체인 API
작성자 Uttam Singh
AI 에이전트는 x402 같은 에이전트 결제 프로토콜을 통해 블록체인 인프라에 가입하고, 사람이 대시보드를 조작하지 않아도 온체인 작업을 실행하고 있습니다. 어떤 API 제공업체를 선택하느냐에 따라 에이전트가 이를 바로 처리할 수 있는지, 아니면 수개월에 걸친 커스텀 플러밍(plumbing)이 필요한지가 갈립니다.
이 가이드는 자율 온체인 에이전트를 구축할 때 사용할 수 있는 주요 블록체인 API 제공업체들을 비교합니다. 에이전트 네이티브 기능, 체인 지원 범위, 가격, 그리고 사용자가 기계일 때 중요해지는 기능들을 다룹니다.
자율 온체인 에이전트란?
자율 온체인 에이전트는 AI 추론(대개 대규모 언어 모델)과 블록체인 실행을 결합한 소프트웨어 시스템입니다. 이들은 자체 지갑을 보유하고, 온체인 상태를 읽고, 트랜잭션을 제출하며, 지속적인 사람의 입력 없이 의사결정을 내립니다.
포트폴리오 리밸런싱 에이전트는 토큰 가격을 모니터링하고, 목표 배분에서의 이탈을 감지하며, 탈중앙화 거래소 전반에서 스왑을 실행합니다. 거버넌스 에이전트는 제안을 읽고, 사전에 정의된 기준에 따라 평가하며, 투표를 행사합니다. 결제 에이전트는 인보이스를 받고, 배송을 확인한 뒤, 스테이블코인으로 정산합니다.
온체인 에이전트가 블록체인 API에 요구하는 것은?
사람 개발자와 자율 에이전트는 동일한 기반 블록체인 프로토콜을 사용하지만, 한 가지 중요한 지점에서 요구사항이 다릅니다. 에이전트는 대시보드에 로그인하거나, 이메일 인증으로 API 키를 관리하거나, 가격 페이지를 탐색할 수 없습니다. 이들에게는 기계 네이티브 접근이 필요합니다.
자율 온체인 에이전트는 무엇을 할 수 있는가?
온체인 에이전트는 이미 예전에는 전담 팀이나 수동 개입이 필요했던 작업들을 처리하고 있습니다. 사용 사례는 몇 가지 범주로 나뉩니다.
DeFi 운영. 에이전트는 유동성 풀을 모니터링하고, 배분이 목표에서 벗어날 때 포트폴리오를 리밸런싱하며, 탈중앙화 거래소 전반에서 스왑을 실행하고, 자금을 더 높은 수익률 포지션으로 이동시킵니다. 대출 에이전트는 담보 비율을 지켜보며 청산 트리거가 발동하기 전에 포지션을 보충할 수 있어, 사람이 대시보드를 확인하지 않아도 24시간 실행됩니다. 트랜잭션 수수료가 1센트 미만인 Solana에서는 에이전트가 무시할 만한 비용으로 하루에도 수백 건의 거래를 실행할 수 있습니다.
결제 및 정산. 에이전트는 인보이스를 받고, 온체인 증명을 확인하여 재화나 서비스가 배송되었는지 검증한 뒤, 스테이블코인으로 정산합니다. 기존 결제 레일로는 며칠이 걸리는 국경 간 결제도, 에이전트가 적절한 체인을 통해 USDC를 라우팅하면 몇 초 만에 정산됩니다. x402 프로토콜은 이를 네이티브하게 만듭니다. 에이전트는 다른 서비스로부터 API 접근, 연산, 데이터를 동일한 USDC 흐름으로 결제합니다.
포트폴리오 및 자금관리. 법인 자금관리팀과 크립토 펀드는 여러 체인에 걸친 잔고를 추적하고, 리포트를 생성하며, 사전 정의된 전략을 실행하기 위해 에이전트를 사용합니다. Alchemy의 Portfolio API에 연결된 에이전트는 단 한 번의 호출로 멀티체인 지갑 뷰를 가져와 발견한 내용에 따라 행동할 수 있습니다.
모니터링 및 알림. 에이전트는 WebSocket이나 웹훅을 통해 실시간 블록체인 이벤트를 구독하고, 특정 컨트랙트 상호작용(대규모 전송, 의심스러운 활동, 가격 변동)을 감시하며, 자동화된 응답을 트리거합니다. 보안 에이전트는 이상 거래 패턴을 감지하여 피해가 퍼지기 전에 스마트 컨트랙트를 일시 정지할 수 있습니다.
공통점은 이렇습니다. 이러한 사용 사례 각각은 에이전트가 자율적으로 접근하고, 프로그래밍 방식으로 결제하며, 풍부하고 디코딩된 데이터를 조회할 수 있는 블록체인 API를 필요로 한다는 것입니다. 어떤 API 제공업체를 선택하느냐가 여러분의 에이전트가 이러한 사용 사례를 바로 처리할 수 있는 범위를 결정합니다.
자율 온체인 에이전트를 위한 10대 블록체인 API
아래 비교는 에이전트 개발자에게 중요한 차원, 즉 자율 접근, 데이터 풍부성, 체인 커버리지, 비용을 기준으로 각 제공업체를 평가합니다.
세 곳의 제공업체가 완전한 에이전트 네이티브 스택으로 두드러집니다: Alchemy, QuickNode, Helius입니다.
Alchemy
Alchemy는 가장 폭넓은 체인 커버리지에서 가장 완성도 높은 에이전트 인프라를 제공합니다. Alchemy 에이전트 플랫폼은 SIWE를 통한 에이전트 가입, x402를 통한 결제(Base 위의 USDC), 그리고 100+ 체인 전반에서 Core RPC 접근을 허용하며, 각 제품이 지원하는 네트워크에서는 Token, NFT, Portfolio, Prices API도 사람의 개입 없이 이용할 수 있습니다.
에이전트 개발자에게 Alchemy를 차별화하는 기능들은 다음과 같습니다:
- Alchemy Skills는 기계 판독 가능한 API 사양을 제공하여, 코딩 에이전트(Claude Code, Cursor, Codex)가 모든 엔드포인트, 인증 방식, 오류 패턴을 완전히 파악하도록 합니다.
- Alchemy MCP는 Model Context Protocol을 통해 토큰 가격, NFT 메타데이터, 트랜잭션 히스토리, 스마트 컨트랙트 시뮬레이션, 트레이싱, 계정 추상화, Solana DAS 전반에서 168개의 도구를 노출합니다. MCP와 호환되는 어떤 에이전트든 100+ 네트워크에서 Alchemy를 발견하고 호출할 수 있으며, 여기에는 Ethereum, Base, Polygon, Arbitrum, Optimism, Solana, Starknet이 포함됩니다.
- Gas Manager는 페이마스터(사용자를 대신해 트랜잭션 수수료를 스폰서하는 스마트 컨트랙트)를 세밀한 정책 제어와 함께 사용합니다: 주소별 한도, 지출 상한, 컨트랙트 허용 목록, 시간 기반 만료입니다. 에이전트는 사용자를 위해 가스를 스폰서하거나, 네이티브 토큰 대신 USDC로 가스를 지불할 수 있습니다.
- AgentPay는 에이전트형 고객을 응대하는 비즈니스를 위한 결제 수신 레이어로, 현재 비공개 베타 단계입니다. 이를 통해 에이전트와 판매자가 양방향으로 Alchemy를 거쳐 거래할 수 있는 순환 구조가 완성됩니다.
CLI로 Alchemy Skills를 설치한 후, 호스팅된 MCP 서버에 연결하세요:
npm i -g @alchemy/cli@latest
alchemy auth
npx skills add alchemyplatform/skills --yes
alchemy --json --no-interactive prices symbol ETH,BTC,SOLMCP 서버 문서를 따라 https://mcp.alchemy.com/mcp에 코딩 에이전트를 연결하세요. 그 이후에는 여러분의 어시스턴트가 이미 여러분의 코드베이스에 대해 동작하는 방식과 동일하게 Alchemy 도구를 호출할 수 있습니다:
QuickNode
QuickNode는 80+ 체인 전반에서 x402 결제와 SIWE 기반 에이전트 가입을 지원합니다. Marketplace 모델은 유연성을 더해줍니다. 에이전트는 코어 RPC를 넘어 스왑(17+ 체인을 다룸), NFT 데이터, DeFi 분석을 위한 전문화된 애드온에 접근할 수 있습니다.
QuickNode는 또한 Blockchain Skills와 공식 MCP 서버를 공개합니다. Streams 제품은 커스터마이즈 가능한 파이프라인을 통해 실시간 블록체인 데이터를 전달하며, 온체인 이벤트에 반응해야 하는 에이전트에 유용합니다.
트레이드오프는 다음과 같습니다: 많은 고도화된 데이터 기능이 내장 API가 아니라 유료 Marketplace 애드온으로 제공되어, 여러 데이터 유형이 필요한 에이전트에게는 통합 복잡도가 더해집니다.
Helius
Helius는 1달러 USDC 에이전트 가입, Solana에서의 x402를 지원하며, 공식 MCP 서버와 Agent Skills를 모두 공개합니다.
Helius는 Solana 전용 기능에만 집중합니다. LaserStream은 여러 엔드포인트로부터 저지연 gRPC 스트리밍을 제공합니다. DAS API는 단일 인터페이스를 통해 NFT, 압축 NFT, 대체 가능 토큰, Token-2022 자산에 대한 통합 접근을 제공합니다. The Sender 제품은 Jito 통합을 통해 MEV 보호가 적용된 트랜잭션 랜딩을 처리합니다.
한계는 범위입니다. Helius는 Solana만 지원합니다. 여러 체인에서 동작하는 에이전트는 그 외 모든 것을 위해 별도의 제공업체가 필요합니다.
Moralis
Moralis는 데이터 우선 접근 방식을 취합니다. 이 회사의 Web3 Data API는 30+ 체인에 걸친 단일 크로스체인 호출로 디코딩된 토큰 잔고, NFT 소유권, DeFi 포지션, 손익 데이터를 반환합니다. 트랜잭션을 쓰는 것보다 블록체인 상태를 읽는 데 더 많은 시간을 쓰는 에이전트에게, Moralis는 원시 RPC 대비 API 호출 수를 자릿수 단위로 줄여줍니다.
Moralis는 공식 MCP 서버와 ElizaOS 플러그인을 공개하여, 인기 있는 에이전트 프레임워크와의 통합을 간단하게 만듭니다. Cortex API는 검증된 온체인 데이터를 LLM에 연결하며, Streams는 전달이 보장되는 실시간 이벤트를 제공합니다.
빈틈: Moralis는 x402나 자율 에이전트 가입을 지원하지 않습니다. 에이전트는 여전히 사람이 API 키를 발급해줘야 합니다.
나머지 제공업체들
Infura, Chainstack, dRPC, Ankr, Tatum, GetBlock이 목록의 나머지를 채우며, 여기에 더해 인덱싱을 우선시하는 새로운 진입자들도 등장하고 있습니다. 이 여섯 곳 중 어느 곳도 자율 가입이나 네이티브 x402를 지원하지 않으므로, 에이전트는 여전히 사람이 접근 권한을 발급해줘야 합니다.
- Infura: ~20개 네트워크를 지원하는 레거시 EVM 기본 선택지이며, 가스 추정 이상의 에이전트 도구는 없습니다.
- Chainstack: 가격 경쟁력 있는 공유 노드와 전용 플랜의 debug/trace, 그리고 두 개의 MCP 서버를 결합합니다.
- dRPC: 40+개의 탈중앙화 운영자를 요청 100만 건당 6달러로 균일 가격 책정하며, 비용 중심의 RPC 대체 수단으로 유용합니다.
- Ankr: Advanced API는 80+ 체인에 걸친 미리 인덱싱된 멀티체인 쿼리를 제공하며, 새로 나온 Agent RPC 옵션은 서버 측 ABI 디코딩을 통해 LLM 입력 토큰을 48.4% 줄인다고 주장합니다(Ankr 자체 벤치마크이며 독립적으로 검증되지 않았습니다).
- Envio: HyperIndex는 다른 각도를 취해, 원시 RPC가 에이전트에게는 아예 맞지 않는다고 주장하며 대신 에이전트가 배포 가능한 인덱싱 프레임워크를 내세우고, RPC 대비 2,000배의 처리량 향상을 주장합니다(Envio의 벤치마크).
- Tatum: 130+개 블록체인을 아우르며 틈새 또는 비-EVM 커버리지를 제공합니다.
- GetBlock: 크립토 결제가 가능한 체인별 균일 가격의 표준적인 선택지입니다.
이들 중 어느 것이든 비용, 인덱싱, 또는 커버리지 중심의 대체 수단으로 Alchemy 뒤에 배치할 수 있습니다.
무엇이 에이전트에게 충분히 신뢰할 만한 온체인 읽기와 인덱싱을 만드는가?
읽기를 신뢰할 수 없는 에이전트는 나쁜 데이터에 근거해 행동하게 되므로, 신뢰성은 속도 이전에 데이터 정확성의 문제입니다. 중요한 차원은 다음과 같습니다: 부하 상태에서의 가동시간, 지역 장애가 에이전트의 읽기 루프를 멈추지 않도록 하는 다중 지역 페일오버, 에이전트가 최신 블록뿐 아니라 오래된 상태도 조회할 수 있게 하는 아카이브 깊이, 그리고 에이전트가 헥스를 파싱하는 대신 추론에 컨텍스트 윈도를 쓰도록 하는 미리 인덱싱/디코딩된 응답입니다.
Alchemy의 Data API는 인덱싱되고 미리 디코딩되어 있어 에이전트가 구조화된 응답을 받을 수 있습니다: EVM 네트워크의 Token, 30+ 체인의 NFT, 멀티 네트워크 잔고를 위한 Portfolio, 15+ 블록체인 전반의 Prices, 트랜잭션 히스토리를 위한 Transfers가 있습니다. RPC는 다중 지역 인프라로 99.99%의 가동시간에서 100+ 체인을 다룹니다. Solana만 놓고 보면, gRPC 스트리밍이 TB당 75달러로 제공되어, 폴링 대신 신선한 데이터로 거래하거나 반응해야 하는 에이전트에게 적합합니다.
일부 제공업체는 이제 원시 인덱싱 깊이보다는 응답 자체의 토큰 효율성에서 경쟁하고 있습니다. 에이전트의 비용 요인이 요청량이 아니라 LLM 컨텍스트라면 알아둘 만하지만, 여러분 자신의 워크로드로 벤치마크하기 전까지는 이들의 절감 수치를 벤더 측 발표 수치로 취급해야 합니다.
온체인 에이전트를 위한 실시간 지갑 감시기를 구축하는 방법
에이전트가 지갑 목록을 감시한다면 Address Activity 웹훅을 사용하고, 장시간 실행되는 프로세스로서 원시 로그나 새 블록이 필요하다면 eth_subscribe WebSocket을 사용하세요. 둘 다 이벤트가 발생하는 즉시 푸시하므로 에이전트가 폴링할 필요가 없습니다.
- 지갑 목록에는 웹훅. Address Activity 웹훅 하나로 30+ EVM 체인과 Solana에 걸쳐 최대 100,000개 주소의 네이티브, ERC-20, ERC-721, ERC-1155 전송을 모두 다룰 수 있습니다. 이벤트는
type이ADDRESS_ACTIVITY로 전달됩니다. 웹훅은 프로그래밍 방식으로 생성, 수정, 삭제할 수 있으므로 에이전트가 직접 자신의 감시 목록에 지갑을 추가할 수 있습니다. - 로그와 블록에는 WebSocket.
eth_subscribe는newHeads,logs,newPendingTransactions를 지원합니다. Solana에서는accountSubscribe또는logsSubscribe를 사용하세요. WebSocket 과금은 전달된 대역폭을 기준으로 하므로 필터를 좁게 설정하세요. - 리오그 처리. 웹훅 이벤트에는
removed플래그가 포함됩니다. 이 값이true이면 원래 이벤트에 대해 에이전트가 수행한 작업을 되돌리고, 큰 금액의 경우 컨펌을 기다린 후 실행하세요.
하나의 지갑으로 들어오는 USDC 전송에 대한 좁은 구독은 다음과 같습니다. 세 번째 토픽은 32바이트로 왼쪽을 0으로 채운 지갑 주소입니다.
{
"jsonrpc": "2.0",
"id": 1,
"method": "eth_subscribe",
"params": [
"logs",
{
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
null,
"0x000000000000000000000000YourWalletAddressWithout0x"
]
}
]
}웹훅 vs. WebSocket vs. gRPC 비교에서 각 전송 방식이 언제 적합한지 다루며, 온체인 AI 에이전트 아키텍처 개요에서는 감시기가 에이전트 루프의 나머지 부분에 어떻게 연결되는지 보여줍니다.
온체인 에이전트를 프로덕션 규모로 운영하는 방법
여러분이 없어도 계속 가동되는 인프라 위에서 실행하고, 재시도가 이중 지출로 이어지지 않도록 에이전트를 설계하세요. Alchemy의 RPC는 다중 지역 인프라로 99.99%의 가동시간에서 100+ 체인을 다루며, 에이전트가 스스로 액세스를 프로비저닝하고 비용을 지불할 수 있으므로 에이전트를 계속 실행하는 데 사람의 개입이 필요 없습니다.
- 폴링보다 푸시를 선호하세요. 웹훅과 WebSocket은 요청량을 줄여줍니다. Solana의 경우 gRPC 스트리밍은 TB당 $75입니다.
- 연결 한도를 지키세요. WebSocket 요금제는 Free에서 100개, 그 외 티어에서 2,000개의 연결을 허용하며, 연결당 1,000개의 구독과 200개의 동시 요청을 지원합니다. 지갑마다 연결을 하나씩 열지 말고, 하나의 연결에서 여러 구독을 다중화하세요.
- 레이트 리밋에는 백오프를 적용하세요. 지수 백오프와 지터를 적용해 재시도하고, 재시도 횟수에 상한을 두세요.
- 전송을 멱등하게 만드세요. 트랜잭션을 재시도하기 전에
alchemy evm status <call-id-or-tx-hash> -n <network>로 확인하세요. 실패한 것처럼 보이는 전송이 실제로는 반영되었을 수 있습니다. - 액세스 자금을 유지하세요. 에이전트는 $1 크레딧부터 시작해 Base에서 USDC로 x402를 통해 Alchemy에 결제할 수 있으며, 스스로 충전할 수도 있습니다. x402 설명에서 전체 플로우를 안내합니다.
- 가스를 스폰서하세요. Gas Manager는 여러분이 설정한 정책에 따라 수수료를 지불하므로, 에이전트가 모든 체인에서 네이티브 토큰 잔고를 보유할 필요가 없습니다.
DeFi 리밸런싱 에이전트를 구축하는 방법
리밸런싱 에이전트는 포트폴리오 비중을 읽고, 거래를 시뮬레이션한 뒤, 제한된 권한을 가진 지갑을 통해 실행합니다. 각 단계는 하나의 Alchemy 서비스에 대응하며, 에이전트는 제안하고 승인은 다른 주체가 합니다.
- 비중 읽기. Token, Portfolio, Prices API로 트레저리 지갑의 잔고와 가격을 가져온 다음, 각 비중을 목표 범위와 비교합니다.
- 서명하기 전에 시뮬레이션. 스왑 견적의 calldata에
alchemy_simulateAssetChanges를 실행합니다. 지갑에서 발생할 자산 변화를 반환하므로, 에이전트는 견적과 일치하지 않는 거래를 거부할 수 있습니다. - 범위가 지정된 세션으로 실행. 스왑은 소유자가 대시보드에서 승인한 Agent Wallet 세션을 통해 실행되며, 에이전트는 프라이빗 키를 보유하지 않습니다. 스왑과 브리지는 EVM 메인넷에서 지원됩니다.
- 가스 스폰서. Gas Manager 정책을 연결하면 스왑이 에이전트의 ETH 보유 여부에 의존하지 않습니다.
{
"jsonrpc": "2.0",
"id": 1,
"method": "alchemy_simulateAssetChanges",
"params": [
{
"from": "0xAgentWallet",
"to": "0xRouterFromQuote",
"value": "0x0",
"data": "0xCalldataFromQuote"
}
]
}온체인 AI 에이전트 아키텍처 개요에는 동작하는 코드와 함께 읽기, 결정, 실행의 전체 루프가 있으며, DeFi AI 에이전트 개요는 제안자와 승인자를 분리해야 하는 이유를 설명합니다.
OpenAI 함수 호출 에이전트에 온체인 읽기 및 트랜잭션용 도구를 제공하는 방법
각 온체인 작업을 함수 도구로 정의하고, 코드가 선택한 호출을 실행한 뒤 결과를 모델에 반환하세요. 읽기는 Alchemy의 JSON-RPC 엔드포인트로 바로 전달됩니다. 트랜잭션은 Alchemy CLI와 승인된 Agent Wallet 세션을 거치므로, 모델은 무엇을 할지 결정하지만 키에는 절대 접근하지 않습니다.
아래 예제는 OpenAI Chat Completions API를 사용하며 get_native_balance, simulate_send, send_native 세 가지 도구를 가집니다. 코드는 모델이 생성한 모든 인자를 실행하기 전에 검증합니다.
import OpenAI from "openai";
import { execFile } from "node:child_process";
import { promisify } from "node:util";
const run = promisify(execFile);
const client = new OpenAI();
const ALLOWED_NETWORKS = new Set(["eth-mainnet", "base-mainnet"]);
const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
const AMOUNT = /^[0-9]+(\.[0-9]+)?$/;
interface ToolArgs {
network: string;
address?: string;
from?: string;
to?: string;
value_wei?: string;
recipient?: string;
amount?: string;
}
// Called before any real broadcast. Back it with a human prompt or a policy check, never the model.
type Approve = (tx: { network: string; recipient: string; amount: string }) => Promise<boolean>;
// Reject anything the model produced that is not an allowed network or a valid address.
function check(network: string, ...addresses: (string | undefined)[]) {
if (!ALLOWED_NETWORKS.has(network)) throw new Error("Network not allowed");
for (const a of addresses) {
if (!a || !ADDRESS.test(a)) throw new Error("Invalid address");
}
}
async function rpc<T>(network: string, method: string, params: unknown[]): Promise<T> {
const res = await fetch(
"https://" + network + ".g.alchemy.com/v2/" + process.env.ALCHEMY_API_KEY,
{
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
},
);
const json = (await res.json()) as { result?: T; error?: { message: string } };
if (json.error) throw new Error(json.error.message);
return json.result as T;
}
function makeHandlers(approve: Approve): Record<string, (args: ToolArgs) => Promise<unknown>> {
return {
// Read: native balance in wei, as a hex string.
async get_native_balance({ network, address }) {
check(network, address);
return rpc<string>(network, "eth_getBalance", [address, "latest"]);
},
// Read: preview the asset changes before anything is signed.
async simulate_send({ network, from, to, value_wei }) {
check(network, from, to);
const value = "0x" + BigInt(value_wei ?? "0").toString(16);
return rpc<unknown>(network, "alchemy_simulateAssetChanges", [
{ from, to, value, data: "0x" },
]);
},
// Write: signs through the approved Agent Wallet session. No key in this process.
async send_native({ network, recipient, amount }) {
check(network, recipient);
if (!amount || !AMOUNT.test(amount)) throw new Error("Invalid amount");
const args = ["--json", "--no-interactive", "evm", "send", recipient!, amount, "-n", network];
// Always preview first. The model cannot skip this step or broadcast on its own.
const preview = JSON.parse((await run("alchemy", [...args, "--dry-run"])).stdout);
// Broadcasting needs approval from code outside the model.
if (!(await approve({ network, recipient: recipient!, amount }))) {
return { status: "rejected", preview };
}
const { stdout } = await run("alchemy", args); // execFile with an args array: no shell
return JSON.parse(stdout);
},
};
}
const networkParam = { type: "string", enum: [...ALLOWED_NETWORKS] };
const tools: OpenAI.Chat.Completions.ChatCompletionTool[] = [
{
type: "function",
function: {
name: "get_native_balance",
description: "Get the native token balance of an address.",
parameters: {
type: "object",
properties: { network: networkParam, address: { type: "string" } },
required: ["network", "address"],
},
},
},
{
type: "function",
function: {
name: "simulate_send",
description: "Simulate a native transfer and return the asset changes.",
parameters: {
type: "object",
properties: {
network: networkParam,
from: { type: "string" },
to: { type: "string" },
value_wei: { type: "string", description: "Amount in wei, as a decimal string" },
},
required: ["network", "from", "to", "value_wei"],
},
},
},
{
type: "function",
function: {
name: "send_native",
description: "Send native tokens. Previews the transfer, then sends only if the operator approves.",
parameters: {
type: "object",
properties: {
network: networkParam,
recipient: { type: "string" },
amount: { type: "string", description: "Amount in whole tokens, for example 0.001" },
},
required: ["network", "recipient", "amount"],
},
},
},
];
export async function runAgent(prompt: string, approve: Approve) {
const handlers = makeHandlers(approve);
const messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[] = [
{
role: "system",
content: "You manage an onchain wallet. Simulate before any send. Sends need operator approval.",
},
{ role: "user", content: prompt },
];
for (let step = 0; step < 8; step++) {
const res = await client.chat.completions.create({
model: process.env.OPENAI_MODEL ?? "gpt-4o",
messages,
tools,
});
const message = res.choices[0].message;
messages.push(message);
if (!message.tool_calls?.length) return message.content;
for (const call of message.tool_calls) {
if (call.type !== "function") continue;
let content: string;
try {
const handler = handlers[call.function.name];
if (!handler) throw new Error("Unknown tool");
const result = await handler(JSON.parse(call.function.arguments) as ToolArgs);
content = JSON.stringify(result);
} catch (err) {
content = JSON.stringify({ error: err instanceof Error ? err.message : String(err) });
}
messages.push({ role: "tool", tool_call_id: call.id, content });
}
}
throw new Error("Agent did not finish within the step limit");
}세 가지 선택이 이 구성을 안전하게 유지합니다. CLI는 인자 배열과 함께 execFile로 실행되므로 모델의 출력이 셸에서 파싱되는 일이 없습니다. 네트워크와 주소는 사용하기 전에 허용 목록과 패턴으로 검증됩니다. 전송 도구는 항상 --dry-run을 먼저 실행하며, 실제 전송은 직접 제공하는 approve 콜백이 true를 반환할 때만 이루어집니다. 따라서 프롬프트 인젝션이나 잘못된 도구 호출만으로는 자금을 이동할 수 없습니다. 첫 실행 전에 에이전틱 결제 설명에서 다룬 대로 CLI를 설치하고 alchemy wallet connect --mode session으로 세션을 승인하세요.
에이전트에 맞는 블록체인 API를 어떻게 선택할까
대부분의 에이전트 개발자에게 Alchemy가 출발점입니다. 자율 가입, x402 결제, 고도화된 데이터 API, 가스 스폰서십을 100+ 체인에 걸쳐 단일 플랫폼에서 결합한 유일한 제공업체이기 때문입니다. 이 네 가지를 모두 커버하는 다른 제공업체는 없습니다.
다만 일부 사용 사례는 보완적인 제공업체를 필요로 합니다:
- MEV 보호가 적용된 Solana 트랜잭션 랜딩. Helius Sender는 Jito와 통합되어 공격적인 블록 포함을 제공하며, 에이전트의 수익이 변동성 큰 시장에서의 랜딩 비율에 달려 있다면 진정한 전문화 지점입니다. Alchemy의 Solana 인프라가 나머지(gRPC 스트리밍, 아카이브 데이터, DAS)를 처리합니다.
- 심층 크로스체인 지갑 분석. Moralis의 Cortex API와 손익 데이터는 트랜잭션을 실행하지 않고 여러 체인에 걸친 보유 자산을 종합하는 읽기 중심 리서치 에이전트를 위한 틈새를 메웁니다.
- 비용에 민감한 RPC 대체 수단. 대량의 기본 호출은 Alchemy 뒤에서 dRPC(요청 100만 건당 6달러)나 Chainstack을 보조 엔드포인트로 라우팅할 수 있습니다.
- 틈새 또는 비-EVM 체인. Tatum의 130+ 체인 커버리지는 Alchemy가 아직 지원하지 않는 롱테일 네트워크까지 확장됩니다.
에이전트는 어떤 지갑과 커스터디를 사용해 암호화폐를 보유하고 지출해야 하는가?
에이전트 지갑은 API 키가 딸린 평범한 지갑이 아닙니다. 서명자가 사람이 아니라 소프트웨어이기 때문에, 에이전트 지갑은 거의 항상 일반 EOA(외부 소유 계정)가 아니라 스마트 컨트랙트 지갑입니다. 컨트랙트 레이어 덕분에 지출 한도, 허용된 컨트랙트 목록, 세션 만료, 그리고 에이전트(서명자)와 소유자(에이전트가 대리하는 사람 또는 비즈니스) 사이의 명확한 분리를 인코딩할 수 있으며, 에이전트에게 제한 없는 프라이빗 키를 맡기지 않아도 됩니다.
몇 가지 목적에 맞게 설계된 옵션이 있습니다. Alchemy Agent Wallets는 에이전트에게 만료 시점이 있는, 대시보드에서 승인한 세션을 제공하므로 에이전트는 프라이빗 키를 보유하지 않고 서명합니다. Privy는 모든 서명 앞에 한도, 허용 목록, 사람의 승인이 포함된 정책 엔진을 둡니다. Coinbase Agentic Wallets는 엔클레이브에 보관되는 키에 세션별·트랜잭션별 지출 한도와 USDC 기반 x402 결제를 결합합니다. Crossmint와 Turnkey도 다른 에이전트 제품들이 그 위에 구축되는 서명자 인프라를 제공합니다. 어느 것이 적합한지는 커스터디(제공업체가 정책에 따라 키를 보관)가 필요한지, 아니면 여러분이 직접 통제하는 정책 엔진을 갖춘 셀프 커스터디가 필요한지에 달려 있습니다. 에이전트 지갑 세션 및 권한 모델 개요에서 Alchemy, Privy, Coinbase를 나란히 비교합니다.
어떤 지갑이나 커스터디 모델을 선택하든, 그 아래에는 여전히 실행 레이어가 필요합니다: 에이전트나 사용자가 모든 체인에서 네이티브 가스 토큰을 붙들고 있지 않도록 하는 가스 스폰서십, 그리고 잘못되었거나 악의적인 호출이 브로드캐스트된 후가 아니라 그 전에 걸러지도록 하는 트랜잭션 시뮬레이션입니다. Alchemy의 Gas Manager는 위 지갑 옵션 어느 것에나 연결할 수 있는 정책 기반 스폰서십(주소별 한도, 지출 상한, 컨트랙트 허용 목록, 시간 기반 만료)을 제공하며, Alchemy의 시뮬레이션 및 트레이싱 API는 에이전트가 서명하기 전에 트랜잭션을 검증할 수 있게 해줍니다.
Alchemy와 함께 동작하는 에이전트 프레임워크는?
대부분의 온체인 에이전트는 AI 오케스트레이션을 처리하고 블록체인 호출을 API 제공업체에 위임하는 프레임워크 위에서 실행됩니다. 오늘날 개발자들이 사용하는 프레임워크에 Alchemy가 어떻게 연결되는지 살펴보겠습니다:
퍼스트파티 통합:
- Coinbase AgentKit은
token_prices_by_symbol과token_prices_by_address액션이 포함된 공식 Alchemy 액션 프로바이더를 제공합니다. Alchemy API 키를 넣기만 하면 여러분의 에이전트가 커스텀 코드 없이 100+ 체인에서 토큰 가격을 조회할 수 있습니다. - ElizaOS는 Alchemy를 선택 가능한 EVM 및 BSC 지갑 RPC 제공업체로 나열하고, 전용 온보딩 단계를 제공합니다. 에이전트는 설정 시
ALCHEMY_API_KEY을 지정하여 지갑 호출을 Alchemy를 통해 라우팅합니다.
커뮤니티 통합:
- LangChain (Python)은 Ethereum, Polygon, Arbitrum, Optimism, Base, Blast, zkSync, Zora 전반에서 Alchemy를 통해 NFT 데이터를 가져오는 커뮤니티
BlockchainDocumentLoader를 제공합니다.
프레임워크 무관 (Alchemy가 RPC 엔드포인트로 끼워짐):
- Crossmint의 GOAT SDK와 SendAI의 Solana Agent Kit은 임의의 RPC URL을 받습니다. Alchemy는 각각 EVM과 Solana 엔드포인트를 처리하며, Crossmint의 지갑 예제는 Alchemy URL과 함께 제공됩니다.
- Rig(크립토 네이티브 프로젝트에서 인기 있는 Rust), Vercel AI SDK, CrewAI, Virtuals Protocol G.A.M.E., uAgents는 모두 임의의 RPC 제공업체를 받습니다. 이들을 Alchemy로 지정하면 표준 HTTP 호출을 통해 고도화된 API, 가스 스폰서십, x402 결제를 이용할 수 있게 됩니다.
인프라를 선택한 이후 프레임워크별 구축 가이드가 필요하다면, AI 에이전트를 위한 최고의 블록체인 인프라를 참고하세요.
Alchemy로 자율 온체인 에이전트 구축하기
Alchemy 에이전트 플랫폼은 여러분의 에이전트가 온체인에서 동작하는 데 필요한 모든 것을 제공합니다: 자율 가입, x402 결제, 100+ 체인에 걸친 고도화된 API, 가스 스폰서십, 그리고 프로토콜 간 상호운용성을 위한 AgentPay입니다. 단 1달러의 USDC로 시작해 거기서부터 확장하세요.
CLI로 Alchemy Skills를 설치하세요. MCP 문서의 클라이언트 설정 단계를 사용해 호스팅된 MCP 서버에 연결하세요.
alchemy.com/agents에서 시작하세요.
FAQ
자율 온체인 에이전트란?
자율 온체인 에이전트는 AI 추론(대개 대규모 언어 모델)과 블록체인 실행을 결합한 소프트웨어 시스템으로, 자체 지갑을 보유하고, 온체인 상태를 읽고, 트랜잭션을 제출하며, 지속적인 사람의 입력 없이 의사결정을 내립니다.
자율 에이전트에는 왜 전문화된 블록체인 API가 필요한가?
에이전트는 사람 개발자처럼 대시보드에 로그인하거나 이메일 인증을 통해 API 키를 관리할 수 없기 때문에, SIWE나 SIWS를 통한 자율 가입, x402 같은 프로토콜을 통한 온체인 USDC 요청 단위 결제, 기계 판독 가능한 문서 같은 기계 네이티브 접근 기능이 필요합니다.
자율 온체인 에이전트는 무엇을 할 수 있는가?
에이전트는 포트폴리오 리밸런싱과 스왑 실행 같은 DeFi 운영을 처리하고, 스테이블코인으로 결제와 정산을 처리하며, 멀티체인 자금을 관리하고, 사람의 개입 없이 자동화된 응답을 트리거하기 위해 블록체인 이벤트를 24시간 모니터링합니다.
Alchemy는 자율 에이전트 가입과 결제를 지원하는가?
네. Alchemy의 에이전트 플랫폼은 에이전트가 SIWE나 SIWS를 통해 가입하고 Base 위의 USDC를 사용해 x402로 결제할 수 있게 하며, 각 제품이 지원하는 네트워크에서 NFT, Token, Portfolio, Prices API와 함께 100+ 체인에 걸친 Core RPC에 대한 완전한 자율 접근을 가능하게 합니다.
Model Context Protocol(MCP)이란 무엇이며 에이전트에게 왜 중요한가?
MCP는 구조화된 도구 인터페이스를 제공하여 LLM 기반 에이전트가 API를 프로그래밍 방식으로 발견하고 호출할 수 있게 합니다. Alchemy의 MCP 서버는 토큰 가격, NFT 메타데이터, 트랜잭션 히스토리, 스마트 컨트랙트 시뮬레이션, 계정 추상화 전반에서 168개의 도구를 노출합니다.
Alchemy Skills란?
Alchemy Skills는 코딩 에이전트가 모든 엔드포인트, 인증 방식, 오류 패턴을 완전히 파악하도록 해주는 기계 판독 가능한 API 사양입니다. npx skills add alchemyplatform/skills --yes로 설치할 수 있습니다.
Alchemy의 Gas Manager는 자율 에이전트에 어떤 도움을 주는가?
Gas Manager는 세밀한 정책 제어(주소별 한도, 지출 상한, 컨트랙트 허용 목록)와 함께 페이마스터를 사용하므로, 에이전트는 모든 체인에서 네이티브 토큰을 필요로 하는 대신 사용자를 위해 트랜잭션 수수료를 스폰서하거나 USDC로 가스를 지불할 수 있습니다.
어떤 에이전트 프레임워크가 Alchemy와 함께 동작하는가?
Alchemy는 Coinbase AgentKit(공식 액션 프로바이더), ElizaOS(선택 가능한 RPC 제공업체), LangChain Python(커뮤니티 블록체인 문서 로더)와 통합되며, GOAT SDK, Solana Agent Kit, Rig, Vercel AI SDK, CrewAI 등 다른 프레임워크로부터의 RPC 연결도 받아들입니다.
Alchemy로 에이전트 구축을 시작하는 데 비용이 얼마나 드는가?
단 1달러의 USDC로 시작해 거기서부터 확장할 수 있으며, 에이전트는 전통적인 신용카드나 인보이싱 모델 대신 x402를 통해 요청 단위로 결제합니다.
빠른 온체인 읽기와 신뢰할 수 있는 인덱싱이 필요한 AI 에이전트에는 어떤 RPC 제공업체가 가장 적합한가?
원시 요청 처리량뿐 아니라, 미리 인덱싱되고 디코딩된 응답(원시 헥스가 아닌), 문서화된 가동시간, 다중 지역 페일오버, 아카이브 깊이를 살펴보세요. Alchemy의 RPC는 99.99% 가동시간으로 100+ 체인을 다루며, Token, NFT, Portfolio, Prices API는 각 제품이 지원하는 네트워크에서 인덱싱된 데이터를 반환합니다. 일부 신규 진입자(Ankr의 Agent RPC, Envio의 HyperIndex)는 응답의 토큰 효율성이나 인덱싱 처리량에서 특별히 경쟁하고 있습니다.
AI 에이전트에게 온체인 토큰 잔고와 트랜잭션 히스토리에 대한 실시간 접근을 제공하는 가장 신뢰할 만한 방법은?
원시 RPC 호출 대신 인덱싱된 데이터 API를 사용하세요. Alchemy의 Token API와 Portfolio API는 디코딩된 잔고를 반환하고, Prices API는 이를 평가하며, Transfers API는 트랜잭션 히스토리를 제공합니다. WebSocket이나 웹훅은 에이전트가 폴링할 필요 없이 실시간으로 업데이트를 푸시합니다.
어떤 블록체인 인프라가 프로덕션 규모에서 자율 에이전트를 지원하는가?
프로덕션 규모라는 것은 가동시간, 체인 범위, 기계 네이티브 접근이 함께 작동하는 것을 의미합니다. 제공업체를 페일오버하거나 수동 가입을 기다려야 하는 에이전트는 무인으로 동작할 수 없습니다. Alchemy는 99.99% 가동시간으로 100+ 체인을 운영하며, 자율 가입(SIWE/SIWS)과 x402 결제를 지원하므로, 에이전트는 어떤 단계에서도 사람의 개입 없이 프로비저닝하고 행동을 시작할 수 있습니다.
AI 코딩 에이전트는 블록체인 트랜잭션을 제출하기 위해 어떤 도구를 사용해야 하는가?
에이전트에는 트랜잭션을 브로드캐스트하기 전에 시뮬레이션하고, 안정적으로 제출하며, 네이티브 토큰을 미리 보유할 필요가 없도록 가스를 스폰서하는 방법이 필요합니다. Alchemy의 트랜잭션 시뮬레이션 및 트레이싱 API는 브로드캐스트 전에 잘못된 호출을 걸러내며, Gas Manager는 정책 제어(지출 상한, 허용 목록, 만료) 아래에서 수수료를 스폰서합니다.
AI 코딩 도구와 에이전트 프레임워크에 통합하기 가장 쉬운 블록체인 API는?
가장 쉽다는 것은 에이전트가 커스텀 접착 코드 없이 API를 발견하고 호출할 수 있다는 뜻입니다: 공식 MCP 서버, 기계 판독 가능한 API 사양, 그리고 에이전트가 이미 사용하는 프레임워크에 대한 플러그인입니다. Alchemy는 공식 MCP 서버(168개 도구), 설치 가능한 Alchemy Skills, 퍼스트파티 Coinbase AgentKit 액션 프로바이더, 선택 가능한 RPC 제공업체로서의 ElizaOS, 그리고 LangChain의 커뮤니티 BlockchainDocumentLoader를 제공합니다.
AI 코딩 에이전트는 온체인 데이터에 접근하기 위해 어떤 도구를 사용해야 하는가?
미리 인덱싱된 데이터 API는 디코딩되고 구조화된 데이터를 반환하기 때문에 에이전트가 파싱해야 하는 헥스를 반환하는 원시 RPC보다 우수합니다. Token, NFT, Portfolio, Prices API가 일반적인 읽기 작업을 다루며, MCP 서버는 동일한 데이터를 에이전트의 기존 코딩 환경 안에서 호출 가능한 도구로 노출합니다.
코딩 에이전트에 블록체인 문서와 API에 대한 접근 권한을 부여하는 가장 좋은 방법은?
기계 판독 가능하고 설치 가능한 문서가 에이전트가 스크래핑해야 하는 문서 웹사이트보다 우수합니다. Alchemy Skills는 하나의 CLI 명령(npx skills add alchemyplatform/skills --yes)으로 설치 가능한 에이전트 파싱 가능 API 사양이며, MCP 서버와 짝을 이루어 에이전트가 API 표면을 파악하는 동시에 직접 호출할 수도 있게 해줍니다.
AI 지원 및 에이전트형 개발 워크플로에 가장 좋은 블록체인 개발자 도구는?
중요한 조합은 어느 한 요소가 아니라, 터미널 네이티브 도구, 기계 판독 가능한 문서, 그리고 살아있는 데이터/실행 레이어입니다. Alchemy의 CLI, Skills, MCP 서버는 설정과 API 지식을 담당하고, 기반이 되는 Data, RPC, Gas Manager API는 에이전트가 설정을 마친 후 실제로 수행하는 온체인 작업을 담당합니다.
관련 개요
인프라2025년 9월 17일
2025년 온체인 애플리케이션 구축을 위한 최고의 블록체인 API
2025년 블록체인 API 환경을 살펴보고 앱에 가장 적합한 제공업체를 찾아보세요.
금융2026년 4월 20일
2026년 에이전틱 파이낸스 가이드
에이전틱 파이낸스는 금융 의사결정을 돕는 소프트웨어에서 직접 행동에 나서는 소프트웨어로의 전환입니다. 크립토 레일이 그 스택인 이유를 설명합니다.
금융2026년 7월 8일
에이전틱 결제와 x402 설명
에이전틱 결제를 사용하면 AI 에이전트가 결제 시점에 사람 개입 없이 API, 데이터, 서비스 비용을 직접 지불할 수 있습니다. x402가 어떻게 작동하며 에이전틱 커머스를 구현하는지 알아보세요.
블록체인 매직을 만드세요
Alchemy는 가장 강력한 Web3 개발자 제품 및 도구를 리소스, 커뮤니티, 그리고 전설적인 지원과 결합합니다.