의도부터 증거까지.

API 키 받기

curl -X POST https://agenttrail.online/api/v1/accounts \
  -H 'Content-Type: application/json' -d '{}'

응답에는 account_id, key_id 및 일회성 api_key가 포함됩니다. 안전하게 저장하세요. 계정 생성 및 새로운 키 발급은 호출이 성공할 때마다 새로운 자격 증명을 생성합니다. 이는 재생 엔드포인트가 아닙니다. 분실된 키는 이 개발 서비스로 복구할 수 없습니다. 콘솔에서 범위가 지정된 에이전트 키를 발급하세요.

1. 예상 지급액을 기록하세요.

export AUDIT_KEY='<save the one-time API key securely>'
curl -X POST https://agenttrail.online/api/v1/audit/intents \
  -H "Authorization: Bearer $AUDIT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-stable-intent-reference' \
  -d '{"agent_id":"research-01","network":"xrpl-testnet", "asset":{"type":"native","currency":"XRP"},"expected_amount":"1","recipient":"<recipient classic address>","purpose":"purchase_market_data"}'

금액은 10진수 문자열입니다. 테스트넷과 메인넷은 혼합될 수 없습니다. 목적과 대리인 신원은 선언일 뿐 승인 증거는 아닙니다. 옵션 payer_address는 발신자 일치를 활성화합니다. 그렇지 않으면 지급인 일치가 확인되지 않습니다. 민감한 작업 컨텍스트에는 context_hash를 사용하세요.

2. 외부에서 결제한 후 해시를 제출하세요.

귀하의 Testnet 결제 코드가 결제를 보냅니다. 지갑 시드나 개인 키를 서비스에 보내지 마십시오.

curl -X POST https://agenttrail.online/api/v1/audit/transactions \
  -H "Authorization: Bearer $AUDIT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-stable-payment-reference' \
  -d '{"audit_id":"<audit_id>","network":"xrpl-testnet","tx_hash":"<64-character hash>"}'

202 응답은 확인이 보류 중임을 의미합니다. 전송 오류 후 동일한 Idempotency-Key 및 요청 본문을 사용하여 감사 쓰기를 재시도합니다. 다른 본문으로 키를 재사용하면 409가 반환됩니다.

3. 상태 확인, 다운로드 및 독립 검증

curl -H "Authorization: Bearer $AUDIT_KEY" \
  https://agenttrail.online/api/v1/audit/records/<audit_id>
curl -H "Authorization: Bearer $AUDIT_KEY" \
  https://agenttrail.online/api/v1/audit/records/<audit_id>/report -o audit.json

결제 상태와 앵커 상태는 별개입니다. anchor_validated만이 완전한 앵커링을 설정합니다. 다운로드한 보고서가 보류 중일 수 있습니다. 독립적인 검증은 분명히 실패해야 합니다. 확인 페이지를 로컬로 사용하거나 저장소에서 scripts/verify_report.py를 실행하세요.

오류 및 지원 경계

400: 잘못된 입력, 잘못된 네트워크 또는 비활성화된 발급자. 401: 키가 잘못되었거나 취소되었습니다. 403: 범위가 부족합니다. 404: 기록이 없거나 접근할 수 없습니다. 409: 멱등성/트랜잭션 충돌 또는 보고서가 준비되지 않았습니다. 413: 몸체가 너무 큽니다. 429: 할당량을 초과했습니다. 나중에 다시 시도하세요. 503: 저장/공급자를 사용할 수 없습니다. 안전하게 다시 시도하세요.

지원되는 결제 해석: 직접 XRP 및 활성화된 RLUSD 자산. 성공적인 부분 결제는 요청된 금액이 아닌 전달된 메타데이터를 사용합니다. 복잡한 경로, 변환 및 비결제 거래는 지원되지 않습니다. 노드 시간 초과는 보류 상태로 유지되며 운영자가 배달 못한 편지 대기열에서 복구해야 할 수도 있습니다.

증명 및 개인정보 보호 경계

보고서 및 선언은 귀하의 계정에만 공개됩니다. 공개 증명은 해시와 최소한의 배치/네트워크 정보를 노출합니다. 앵커는 모든 지불에 대한 청구, 전달 또는 적용 범위가 아니라 제공된 기록의 무결성을 입증합니다. 플랫폼 앵커링은 제한된 전용 테스트넷 서명자, 명시적 예산 및 운영자 활성화 단계를 사용합니다.