개발자 · 에이전트

에이전트가 먼저 단일 호출 경로를 구축하도록 하세요.

최적의 에이전트 경로는 짧습니다. 스킬을 로드하고, offramp(walletClient, params)를 호출하고, 위임을 확인한 다음, 제품에 웹훅 또는 Peerlytics 경로 데이터가 필요할 때만 추가하세요.

01

에이전트 컨텍스트 팩

리소스용도
skills/usdctofiat.mdSDK 규칙, 플랫폼, OTC, 웹훅 및 예시가 포함된 드롭인 스킬
llms.txt짧은 기계 가독성 제품 및 경로 요약
llms-full.txt계약, 가격, 가이드 및 답변이 포함된 전체 기계 참조
OFFRAMP_DEVELOPER_RESOURCES링크, 위임 구성, upstreamSourceTruths 및 플레이북이 포함된 타입 SDK 내보내기
OFFRAMP_INTEGRATION_CHECKLIST위임, 중복 방지, 익스텐션 복구, HMAC 웹훅에 대한 타입 통합 의사 검사
getOfframpAgentPrompt(profile)에이전트 구축 통합을 위한 복사 가능한 프롬프트 빌더
스타터 리포작동하는 Next.js, Vite, Telegram 봇, 스크립트 및 웹훅 예시
02

프롬프트 시퀀스

  1. 1계획을 세우기 전에 스킬과 llms.txt를 읽도록 에이전트에게 지시합니다.
  2. 2데이터 플레인 기능을 추가하기 전에 단일 호출 offramp(walletClient, params) 경로를 먼저 출시하도록 지시합니다.
  3. 3프로필을 선택합니다: app, bot, agent, private-otc, webhooks 또는 peerlytics.
  4. 4가능하면 create-offramp-app 또는 스타터 리포에서 스캐폴드하도록 요청합니다.
  5. 5생성된 모든 예치금이 Delegate 환율 관리자에게 위임되는지 확인하도록 요구합니다.
  6. 6Peerlytics를 추가하는 경우 원시 오더북 읽기 전에 planRoutes()를 요구합니다.
  7. 7웹훅을 추가하는 경우 JSON 파싱 전에 원시 바디 HMAC 검증을 요구합니다.
03

에이전트가 만들어서는 안 되는 것

  • 샌드박스를 만들지 마세요. SDK는 Base 메인넷을 대상으로 합니다.
  • 위임을 제거하지 마세요. SDK의 예치금 경로는 Delegate 볼트에 위임해야 합니다.
  • 법정화폐를 SDK가 제어하는 것으로 처리하지 마세요. 법정화폐는 구매자와 판매자 사이에서 직접 이동합니다.
  • 증명 페이로드, 자격 증명 필드 또는 결제 수단 해시를 조작하지 마세요. 먼저 upstreamSourceTruths를 확인하세요.
  • 파싱된 JSON에서 웹훅 서명을 검증하지 마세요. 먼저 timestamp.rawBody를 검증하세요.

Common questions

에이전트가 먼저 무엇을 읽어야 하나요?

https://usdctofiat.xyz/skills/usdctofiat.md로 시작한 다음, 모델이 유지할 수 있는 컨텍스트 양에 따라 llms.txt 또는 llms-full.txt를 읽으세요.

에이전트가 패키지에서 이를 발견할 수 있나요?

예. @usdctofiat/offramp에서 OFFRAMP_DEVELOPER_RESOURCES, OFFRAMP_INTEGRATION_CHECKLIST를 가져오고, OFFRAMP_DEVELOPER_RESOURCES.upstreamSourceTruths를 읽고, getOfframpDeveloperResources(profile)을 호출하거나 getOfframpAgentPrompt(profile)을 호출하세요.