agent-credit

agent-credit란?

agent-credit는 AI 에이전트용 신용 위임 툴킷으로, 에이전트가 Aave 포지션에서 자금을 대출받고 나중에 위임자의 대신 상환할 수 있게 합니다. 핵심 아이디어는 에이전트의 대출 권한과 부채 상환을 분리하는 것으로, 에이전트가 대출할 수 있는 자산과 금액을 정의할 수 있으며 대출 용량은 본인의 담보에서 제공됩니다.

리포지토리는 위임 상태 설정, 위임 대출 실행, 위임 부채 상환, 실행 전 허용량/건전성 확인을 위한 bash 스크립트(에이전트가 호출)를 제공합니다. Aave V2 및 Aave V3가 배포된 EVM 체인에서 작동하도록 설계되었으며, 리포지토리 예시는 Base, Ethereum, Polygon, Arbitrum에 사전 구성되어 있습니다.

주요 기능

• Aave를 통한 위임 대출: 에이전트가 자금이 필요할 때 Aave에서 대출하며, 발생한 부채는 위임자의 Aave 포지션에 누적됩니다.
• 자산별 위임 승인: 각 부채 토큰 계약(예: USDC vs WETH)에 대해 독립적으로 위임을 승인하므로, 명시적으로 허용하지 않은 자산은 대출할 수 없습니다.
• 담보 기반 전체 대출 용량: 대출 파워는 전체 담보 포지션과 설정된 LTV에서 유래하지만, 각 자산의 가용 대출은 설정한 위임 승인에 의해 제한됩니다.
• 에이전트 실행을 위한 스크립트 워크플로: 제공된 스크립트는 설정 확인, 위임 대출 호출, 위임 상환, 상태 보고를 처리하며, 안전 확인 실패 시 중단합니다.
• 대출 전 안전 확인: 각 대출은 거래당 상한, 위임 허용량 충분성, 대출 후 건강 지수, 에이전트 지갑의 가스용 ETH 충분 여부를 확인합니다.
• 프라이빗 키 노출 방지를 위한 키 처리: 에이전트는 위임자의 프라이빗 키를 받지 않으며, 자체 키로 대출/상환 거래를 서명하고 위임자의 공개 주소로 올바른 Aave 포지션을 타겟팅합니다.
• 설정 가능한 안전 매개변수: 대출 스크립트는 safety.maxBorrowPerTx 및 safety.minHealthFactor(기본값 1.5로 언급) 등의 구성 값을 참조합니다.

agent-credit 사용 방법

1. 지갑에서 위임 설정: Aave UI 또는 블록 탐색기를 사용해 담보를 구성한 후, 에이전트가 대출할 수 있는 특정 부채 토큰에 대한 위임 승인을 설정합니다(예: USDC 부채 토큰 → 에이전트 금액).
2. 구성 준비: 스크립트에서 사용하는 값(안전 매개변수 및 대출 대상 포함)을 정의하기 위해 config.example.json을 시작점으로 사용합니다.
3. 에이전트에서 제공 스크립트 실행: 리포지토리 스크립트는 위임자용이 아닌 에이전트 실행을 위해 설계되었습니다. 일반적인 스크립트 흐름은 다음과 같습니다:
   • aave-setup.sh: 구성/의존성 및 위임 상태 확인
   • aave-borrow.sh <SYMBOL> <AMOUNT>: 안전 확인 후 위임 대출
   • aave-repay.sh <SYMBOL> <AMOUNT|max>: 위임자 대신 부채 상환
   • aave-status.sh [SYMBOL] [--health-only] [--json]: 허용량 및 건강 지수 확인
4. 필요 시 위임 취소: 관련 부채 토큰에 대해 위임 금액을 0으로 설정하여 언제든지 위임을 취소할 수 있습니다.

사용 사례

• 수동 자금 충전 없이 주문형 에이전트 운영: 에이전트는 운영 비용 충당 시에만 위임을 통해 스테이블코인 또는 토큰을 대출하며, 지갑 사전 충전을 반복할 필요가 없습니다.
• DeFi 툴킷을 통한 에이전트 주기적 스왑 관리: 리포지토리에서 설명된 Bankr 스킬과 결합해 에이전트가 위임으로 USDC를 대출한 후 Bankr 플로우로 스왑/브릿지/배포할 수 있습니다.
• 위임 USDC를 활용한 자율 DCA: 에이전트가 주기적으로 USDC를 대출해 스왑으로 ETH를 획득하는 DCA 유사 워크플로를 실행할 수 있습니다.
• 실행 가스 자립성: 설정에서 에이전트의 ETH 잔고가 부족할 때 소량의 WETH를 대출해 자체 가스를 충당합니다.
• 건강 지수 보호 유동성 접근: 각 대출 전 스크립트가 위임자의 건강 지수를 확인하고, 대출 후 건강 지수가 설정 임계값을 위반할 경우 거래를 중단합니다.

FAQ

에이전트가 위임자의 개인 키에 접근하나요? 아니요. 안전 섹션에서 에이전트는 위임자의 개인 키에 절대 접근하지 않으며, 자체 키를 보유해 대출/상환 거래에 서명하고 위임자의 공개 주소만 사용해 올바른 포지션을 선택한다고 명시되어 있습니다.

에이전트는 대출 가능 금액을 어떻게 결정하나요? 대출 용량은 위임자의 전체 담보 포지션(전체적)에서 나오지만, 각 자산에 대한 에이전트의 대출 가능 금액은 approveDelegation()을 통해 설정된 부채 토큰별 위임 승인으로 제한됩니다.

안전하지 않은 대출을 방지하는 것은 무엇인가요? 각 대출마다 스크립트가 거래당 상한(safety.maxBorrowPerTx), 위임 허용량 충분성, 건강 요인 제약(safety.minHealthFactor, 기본 1.5로 언급), 에이전트의 가스용 ETH 충분 여부 등의 점검을 실행합니다. 점검이 실패하면 대출이 오류와 함께 중단됩니다.

어떤 네트워크와 Aave 버전을 지원하나요? 저장소에 따르면 Aave V2와 Aave V3에서 작동하며, Base, Ethereum, Polygon, Arbitrum에 사전 설정되어 있고, Aave가 배포된 모든 EVM 체인에서 사용 가능하도록 설계되었습니다.

에이전트가 다른 에이전트 프레임워크 내에서 이 흐름을 실행할 수 있나요? 콘텐츠에 따르면 스크립트는 일반 bash와 Foundry의 cast로 구성되어 셸이 있는 모든 환경에서 사용할 수 있습니다. 저장소는 OpenClaw(스킬로 설치)와 Claude Code 세션에서 직접 스크립트 실행 호환성을 언급합니다.

대안

• 지갑/UI를 통한 수동 Aave 상호작용: 에이전트에게 대출을 위임하는 대신, 당신(또는 백엔드 서비스)이 Aave에서 수동으로 담보 제공, 대출, 상환을 수행할 수 있습니다; 이는 제어를 유지하지만 더 빈번한 인간 개입이나 맞춤 통합이 필요합니다.
• 타사 에이전트-to-DeFi 커넥터: 이 카테고리의 대안은 DeFi 프로토콜에 대한 에이전트 친화적 인터페이스를 제공하지만, Aave 신용 위임과 부채 토큰별 승인 제약을 동일하게 사용하지 않을 수 있습니다.
• 온체인 계약 기반 “에이전트 지갑” 대출: 일부 시스템은 에이전트 작업을 전용 스마트 계약으로 라우팅합니다; 이는 부채 토큰별 Aave 위임 승인이 아닌 계약 로직으로 권한 모델이 적용되는 점에서 다릅니다.
• 맞춤 위임 + 안전 레이어 구축: Aave 계약과 거래 가드를 사용해 위임 관리와 대출 안전 점검을 직접 재구현할 수 있습니다; 이는 이 저장소의 즉시 사용 가능한 bash 스크립트와 설정 규칙과 다릅니다.