Improved
Aptos Data API & Webhook Updates: Events, Transactions, Fee Payer Signatures
4 days ago
Nodit 개발자 문서 1.2.24 버전에서 다음과 같은 업데이트가 반영되었습니다.
이번 업데이트는 Aptos Data API(Event/Transaction) 개선, Webhook(Transaction 이벤트) payload 개선을 포함합니다.
1. Aptos Data API 업데이트
이번 업데이트에서는 Aptos Data API의 이벤트 조회 방식이 개선되었으며, 트랜잭션 응답 필드 타입이 통일됩니다.
1-1. Aptos Event API 신규 추가 (이벤트 조회 통합)
Aptos 이벤트 조회를 위한 신규 API가 추가되었습니다.
기존에는 이벤트 타입에 따라 Indexer API 또는 Node API를 구분하여 사용해야 했지만, 이제는 신규 Event API를 통해 module 기반 이벤트와 legacy(event-handle) 이벤트를 모두 동일한 방식으로 조회할 수 있습니다.
이에 따라 기존 Aptos Indexer API의 Event 스키마는 추후 deprecated 될 예정입니다.
이번 업데이트에서 즉시 deprecated 되지는 않으며, 상세 일정은 별도 공지로 안내됩니다.
1-2. Transaction 응답 필드 타입 통일
Aptos Data API 트랜잭션 응답에서 다음 필드의 타입이 일관성을 위해 변경됩니다.
변경 내용
| Field | As-is | To-be |
|---|---|---|
blockHeight | string | integer |
blockTimestamp | string (ISO 8601) | integer (Unix timestamp in ms) |
Affected APIs
- Get Transactions By Versions
- Get Transaction By Version
- Get Transaction By Hash
- Get Transactions In Block
- Get Transactions By Hashes
- Get Transactions By Account
2. Aptos Webhook 업데이트
Aptos Webhook에서 Transaction 웹훅 이벤트의 payload가 개선되었습니다.
fee payer 트랜잭션의 signature 정보가 더 정확하게 제공되며, payload 구조도 더 명확해졌습니다.
주요 변경 요약
| Field | As-is | To-be |
|---|---|---|
signature.type | multi_agent_signature | fee_payer_signature |
signature.type | single_sender_keyless_signature | fee_payer_signature |
signature.public_key / signature.signature | "0x..." | {type, value} (일부 타입) |
signature.fee_payer_address | 미제공 | 제공 |
signature.fee_payer_signer | 미제공 | 제공 |
signature.secondary_signers | 미제공 | 제공 |
payload.type_arguments (multisig) | [] | 실제 값 |
payload.transaction_payload (null case) | {function: "", arguments: []} | 제거 |