키를 넘기지 않고 AI 에이전트에게 지갑을 제공하세요

AI 에이전트가 이제 온체인에서 전송, 스왑, 브리지, 예치를 할 수 있습니다. 터미널에서, 프라이빗 키를 직접 소지하지 않고도요.

오늘 저희는 Alchemy CLI에 에이전트 지갑 기능을 출시합니다. 개발자는 Alchemy 대시보드에서 지갑을 생성하고, CLI에 범위가 제한되고 시간이 한정된 접근 권한을 부여해, 에이전트가 커맨드라인에서 실제 트랜잭션을 실행하도록 할 수 있습니다. 지갑은 오직 대시보드에서만 생성되거나 해지됩니다. 지갑의 프라이빗 키는 CLI에 닿지 않고, Alchemy에도 닿지 않으며, .env 파일에 저장되지도 않습니다.

위 데모에서 Claude는 USDC에 가장 적합한 Aave 마켓을 찾아내고, 자금을 알맞은 체인으로 브리지한 뒤, 풀에 예치합니다. 오늘 이전까지 이런 워크플로우를 구현하려면 프라이빗 키를 직접 소지하는 커스텀 에이전트 코드가 필요하거나, 지갑 SDK와 코딩 어시스턴트를 직접 연동하는 통합 작업이 필요했습니다. 이제는 몇 개의 명령어와 대시보드 클릭 한 번이면 됩니다.

지금까지 에이전트가 온체인에서 거래해온 방식

지금까지 개발자에게는 대체로 두 가지 실행 가능한 경로가 있었고, 둘 다 좋은 기본 선택지는 아니었습니다. 개발자가 .env에 프라이빗 키를 붙여넣고 에이전트가 해당 자금을 완전히 통제하게 되는 것을 받아들이거나, 지갑 SDK를 커스텀 백엔드에 연결해 인증, 서명, 해지 로직을 직접 구현하는 것입니다. 첫 번째 방법은 프롬프트 하나만 잘못 되어도 지갑이 비워질 수 있습니다. 두 번째 방법은 대부분의 팀이 굳이 해야 할 필요가 없는 몇 주 분량의 작업입니다.

CLI의 에이전트 지갑은 이 두 가지를 모두 대체합니다. 지갑에 대한 커스터디는 Alchemy 대시보드를 통해 계속 유지됩니다. 에이전트는 터미널에서 여러분이 승인한 범위가 제한된 세션을 받습니다. 해당 세션은 클릭 한 번으로 해지할 수 있습니다.

작동 방식

이 아키텍처는 책임을 세 가지로 분리합니다. 임베디드 지갑 파트너인 Privy가 지갑의 프라이빗 키를 안전하게 보관합니다. 저희는 그 사이에서 CLI 세션과 검증 계층을 담당합니다. 여러분은 대시보드를 통해 승인 및 해지 권한을 갖습니다.

alchemy wallet connect를 실행하면 CLI는 여러분의 기기에서 새로운 P-256 키페어를 생성합니다. 프라이빗 키는 기기 밖으로 나가지 않습니다. 브라우저가 Alchemy 대시보드로 열리고, 여기서 에이전트가 사용할 지갑을 생성하거나 선택하고 세션을 승인합니다. 승인이 이루어지면 CLI의 퍼블릭 키가 해당 지갑의 서명자로 등록되며, 특정 기능으로 범위가 제한되고 대시보드에서 설정한 세션 만료 시점까지로 한정됩니다.

모든 서명 호출은 2단계 과정으로 이루어집니다: Alchemy 백엔드가 Privy가 요구하는 정규 페이로드를 구성하고, 여러분의 CLI가 로컬에서 정확한 바이트에 서명한 뒤에야 요청이 Privy에 도달합니다. 세션이 만료되거나, 대시보드에서 해지되거나, 바인딩 검사를 통과하지 못하면, 다음 서명 시도는 저희 인프라를 벗어나기도 전에 거부됩니다. 해지는 클릭 한 번으로 즉시 적용됩니다.

세션이 활성화되면 에이전트는 전체 트랜잭션 범위에 접근할 수 있습니다: 전송, 스왑, 브리지, 컨트랙트 호출까지요. 트랜잭션은 저희 Wallet API를 거치므로, 가스 스폰서십, 배칭, 자동 재시도, ERC-20 가스 결제, 크로스체인 스왑까지 함께 제공됩니다. 이미 조회를 위해 Data API를 감싸고 있던 동일한 CLI가 이제 여러분이 승인한 지갑을 통해 트랜잭션을 전송합니다.

처음부터 코딩 에이전트를 위해 설계됨

Alchemy CLI는 처음부터 AI 에이전트를 위한 도구 인터페이스로 설계되었습니다. 이 의도를 담은 두 개의 플래그가 있습니다: --json은 파싱을 위한 구조화된 출력을 반환하고, --no-interactive는 프롬프트를 비활성화해 명령어가 입력 대기 상태로 멈추지 않도록 합니다. 또한 alchemy agent-prompt 명령어는 모든 명령어, 모든 플래그, 모든 에러 코드, 실행 가능한 예제를 설명하는 JSON 문서를 출력합니다. 이를 시스템 프롬프트에 넣으면 에이전트는 한 번에 전체 인터페이스를 학습합니다.

즉, 에이전트는 새로운 지갑 관련 명령어를 자동으로 습득합니다. SDK를 통합할 필요도, 문서 페이지를 해석할 필요도, 모델에게 새 명령어의 작동 방식을 가르치기 위한 프롬프트 엔지니어링도 필요 없습니다. CLI가 직접 에이전트에게 알려줍니다.

오늘부터 사용 가능한 기능

CLI의 에이전트 지갑은 지금 바로 사용할 수 있으며, 대기 명단도 별도의 요금제도 없습니다. Node 22 이상과 Alchemy 계정만 있으면 됩니다. 세션 및 지갑 관리 인터페이스는 대시보드에, 트랜잭션 인터페이스는 터미널에 있습니다.

세 개의 명령어만으로 에이전트가 제어할 수 있는 지갑을 바로 사용할 준비가 끝납니다. 모든 명령어, 모든 플래그, 지원되는 모든 네트워크를 포함한 전체 레퍼런스는 CLI 문서에서 확인할 수 있습니다.

온체인에서 동작해야 하는 에이전트를 만들고 계시다면, CLI가 저희가 권하는 인터페이스입니다. CLI를 설치하고 대시보드에 로그인하세요.