|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: Changelog |
| 4 | +--- |
| 5 | + |
| 6 | +# Changelog |
| 7 | + |
| 8 | +All notable structural changes to the Transaction Authorization Protocol (TAP) are documented in this file. |
| 9 | + |
| 10 | +This changelog focuses on: |
| 11 | +- New TAIPs and their acceptance status |
| 12 | +- Message format changes |
| 13 | +- Protocol structural changes |
| 14 | +- Breaking changes |
| 15 | + |
| 16 | +## [Unreleased] |
| 17 | + |
| 18 | +### Added |
| 19 | +- JSON Schema definitions for all TAP message types in `/schemas/` directory |
| 20 | +- Developer resources page with implementation guides |
| 21 | +- TypeScript fixes: Added `by` field to Cancel interface |
| 22 | + |
| 23 | +### Removed |
| 24 | +- Complete message type (replaced by extended Authorize message) |
| 25 | +- Test vectors for removed Complete message |
| 26 | + |
| 27 | +## [2025-06-23] |
| 28 | + |
| 29 | +### Changed |
| 30 | +- **BREAKING**: Replaced `Complete` message with enhanced `Authorize` message to simplify flow |
| 31 | +- Made `originator` field optional in Transfer messages to support unknown originators |
| 32 | +- Made `role` field optional in Agent structures |
| 33 | +- Added `principal` as primary party in Connection messages |
| 34 | + |
| 35 | +## [2025-04-22] |
| 36 | + |
| 37 | +### Added |
| 38 | +- TAIP-16: Invoices - Structured invoice format for payment requests |
| 39 | +- MCC (Merchant Category Code) field to Party structure for merchant identification |
| 40 | + |
| 41 | +## [2025-03-31] |
| 42 | + |
| 43 | +### Added |
| 44 | +- `expiry` fields to Transfer, Authorize, and Connect messages for business intent expiration |
| 45 | +- Complete message for payment completion flows |
| 46 | +- `amount` field to Settle message for partial settlement support |
| 47 | + |
| 48 | +### Changed |
| 49 | +- Distinguished between message expiration (`expires_time`) and business expiration (`expiry`) |
| 50 | + |
| 51 | +## [2025-03-30] |
| 52 | + |
| 53 | +### Changed |
| 54 | +- **BREAKING**: Renamed `PaymentRequest` to `Payment` throughout codebase |
| 55 | +- Updated all references and test vectors |
| 56 | + |
| 57 | +## [2025-03-26] |
| 58 | + |
| 59 | +### Added |
| 60 | +- TAIP-15: Agent Connection Protocol - OAuth-style authorization flows for B2B integrations |
| 61 | +- Connect message for establishing agent connections |
| 62 | +- AuthorizationRequired message for connection approval flows |
| 63 | + |
| 64 | +## [2025-03-11] |
| 65 | + |
| 66 | +### Added |
| 67 | +- TAIP-13: Transaction Purpose Codes - ISO 20022 purpose code integration |
| 68 | +- Purpose and categoryPurpose fields to Transfer messages |
| 69 | +- PaymentRequest message (later renamed to Payment) |
| 70 | + |
| 71 | +## [2025-03-10] |
| 72 | + |
| 73 | +### Added |
| 74 | +- TAIP-14: Payment Requests - Merchant-initiated payment flows |
| 75 | + |
| 76 | +## [2025-03-07] |
| 77 | + |
| 78 | +### Added |
| 79 | +- Cancel message for transaction termination |
| 80 | +- Revert message for transaction reversal requests |
| 81 | + |
| 82 | +## [2025-03-05] |
| 83 | + |
| 84 | +### Added |
| 85 | +- TAIP-11: Legal Entity Identifier (LEI) - Institutional participant identification |
| 86 | +- TAIP-12: Hashed Participant Name Sharing - Privacy-preserving name matching |
| 87 | +- `lei` field to Party structure |
| 88 | +- `nameHash` field to Party structure |
| 89 | + |
| 90 | +## [2025-03-02] |
| 91 | + |
| 92 | +### Added |
| 93 | +- TAIP-10: IVMS101 for Travel Rule - Regulatory compliance integration |
| 94 | +- `ivms101` field to Party structure for Travel Rule data |
| 95 | + |
| 96 | +## [2024-01-26] |
| 97 | + |
| 98 | +### Added |
| 99 | +- TAIP-9: Proof of Relationship - Agent-party relationship verification |
| 100 | +- ConfirmRelationship message |
| 101 | +- CACAO attachment support for DID proofs |
| 102 | + |
| 103 | +## [2024-01-25] |
| 104 | + |
| 105 | +### Added |
| 106 | +- TAIP-8: Selective Disclosure - Privacy-preserving credential sharing |
| 107 | +- RequirePresentation policy type |
| 108 | +- Presentation Exchange integration |
| 109 | + |
| 110 | +## [2024-01-24] |
| 111 | + |
| 112 | +### Added |
| 113 | +- TAIP-7: Agent Policies - Requirement enforcement framework |
| 114 | +- Policy structures: RequireAuthorization, RequirePresentation, RequirePurpose |
| 115 | +- UpdatePolicies message |
| 116 | + |
| 117 | +## [2024-01-23] |
| 118 | + |
| 119 | +### Added |
| 120 | +- TAIP-6: Transaction Parties - Party identification and representation |
| 121 | +- Party data structure with name, LEI, and verification methods |
| 122 | + |
| 123 | +## [2024-01-09] |
| 124 | + |
| 125 | +### Added |
| 126 | +- TAIP-3: Virtual Asset Transfer - Core transfer functionality |
| 127 | +- TAIP-4: Transaction Authorization Protocol - Core authorization flow |
| 128 | +- TAIP-5: Transaction Agents - Software agent framework |
| 129 | +- Transfer message for asset transfers |
| 130 | +- Authorization flow messages: Authorize, Settle, Reject |
| 131 | +- Agent management messages: UpdateAgent, AddAgents, ReplaceAgent, RemoveAgent |
| 132 | +- Agent data structure with roles and policies |
| 133 | + |
| 134 | +## [2023-12-19] |
| 135 | + |
| 136 | +### Added |
| 137 | +- TAIP-1: Transaction Authorization Improvement Proposals - Framework document |
| 138 | + |
| 139 | +## [2023-12-14] |
| 140 | + |
| 141 | +### Added |
| 142 | +- TAIP-2: Messaging - DIDComm v2 message format |
| 143 | +- Base message structure and threading model |
| 144 | +- JSON-LD context definitions |
| 145 | +- Initial repository structure |
| 146 | + |
| 147 | +## Message Type Summary |
| 148 | + |
| 149 | +### Current TAP Messages (16 total) |
| 150 | +1. **Transfer** - Virtual asset transfer initiation |
| 151 | +2. **Payment** - Payment request with invoice support |
| 152 | +3. **Authorize** - Transaction authorization (enhanced to replace Complete) |
| 153 | +4. **Settle** - On-chain settlement confirmation |
| 154 | +5. **Reject** - Transaction rejection |
| 155 | +6. **Cancel** - Transaction cancellation |
| 156 | +7. **Revert** - Transaction reversal request |
| 157 | +8. **UpdateAgent** - Agent information update |
| 158 | +9. **UpdateParty** - Party information update |
| 159 | +10. **AddAgents** - Add agents to transaction |
| 160 | +11. **ReplaceAgent** - Replace existing agent |
| 161 | +12. **RemoveAgent** - Remove agent from transaction |
| 162 | +13. **ConfirmRelationship** - Confirm party-agent relationship |
| 163 | +14. **UpdatePolicies** - Update agent policies |
| 164 | +15. **Connect** - Establish agent connection |
| 165 | +16. **AuthorizationRequired** - Request connection authorization |
| 166 | + |
| 167 | +### Removed Messages |
| 168 | +- **Complete** (2024-06-12) - Functionality merged into Authorize message |
| 169 | + |
| 170 | +## Breaking Changes Summary |
| 171 | + |
| 172 | +### 2024-06-12 |
| 173 | +- Complete message removed - migrate to Authorize with settlement details |
| 174 | +- Cancel message now requires `by` field |
| 175 | + |
| 176 | +### 2024-03-15 |
| 177 | +- PaymentRequest renamed to Payment - update all message type references |
| 178 | + |
| 179 | +### 2024-02-10 |
| 180 | +- Transfer message supports optional originator - handle missing originator cases |
| 181 | + |
| 182 | +--- |
| 183 | + |
| 184 | +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), |
| 185 | +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) for protocol versions. |
0 commit comments