{"id":28527787,"url":"https://github.com/semiotic-ai/timeline-aggregation-protocol","last_synced_at":"2026-01-26T22:21:17.465Z","repository":{"id":169897200,"uuid":"602784124","full_name":"semiotic-ai/timeline-aggregation-protocol","owner":"semiotic-ai","description":"A fast, efficient and trust-minimized unidirectional micro-payments system.","archived":false,"fork":false,"pushed_at":"2025-10-24T20:35:05.000Z","size":1180,"stargazers_count":23,"open_issues_count":3,"forks_count":7,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-11-18T00:17:41.678Z","etag":null,"topics":["graphprotocol"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/semiotic-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-16T23:47:21.000Z","updated_at":"2025-10-19T17:00:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"528d191b-acf0-4eb2-b70d-6ff81cfd7433","html_url":"https://github.com/semiotic-ai/timeline-aggregation-protocol","commit_stats":null,"previous_names":["semiotic-ai/timeline_aggregation_protocol","semiotic-ai/timeline-aggregation-protocol"],"tags_count":71,"template":false,"template_full_name":null,"purl":"pkg:github/semiotic-ai/timeline-aggregation-protocol","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semiotic-ai%2Ftimeline-aggregation-protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semiotic-ai%2Ftimeline-aggregation-protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semiotic-ai%2Ftimeline-aggregation-protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semiotic-ai%2Ftimeline-aggregation-protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/semiotic-ai","download_url":"https://codeload.github.com/semiotic-ai/timeline-aggregation-protocol/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semiotic-ai%2Ftimeline-aggregation-protocol/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28789725,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T21:49:50.245Z","status":"ssl_error","status_checked_at":"2026-01-26T21:48:29.455Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["graphprotocol"],"created_at":"2025-06-09T12:15:37.126Z","updated_at":"2026-01-26T22:21:17.447Z","avatar_url":"https://github.com/semiotic-ai.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Timeline Aggregation Protocol (TAP)\n\n| Crate                  | Version Badge                                                                                                      |\n| ---------------------- | ------------------------------------------------------------------------------------------------------------------ |\n| **tap_aggregator**     | [![Crates.io](https://img.shields.io/crates/v/tap_aggregator.svg)](https://crates.io/crates/tap_aggregator)        |\n| **tap_core**           | [![Crates.io](https://img.shields.io/crates/v/tap_core.svg)](https://crates.io/crates/tap_core)                    |\n| **tap_eip712_message** | [![Crates.io](https://img.shields.io/crates/v/tap_eip712_message.svg)](https://crates.io/crates/tap_eip712_message)|\n| **tap_graph**          | [![Crates.io](https://img.shields.io/crates/v/tap_graph.svg)](https://crates.io/crates/tap_graph)                  |\n| **tap_receipt**        | [![Crates.io](https://img.shields.io/crates/v/tap_receipt.svg)](https://crates.io/crates/tap_receipt)              |\n\n## Overview\n\nThe TAP (Timeline Aggregation Protocol) facilitates a series of payments from a \nsender to a receiver (TAP Receipts), who aggregates these payments into a single \npayment (a Receipt Aggregate Voucher, or RAV). This aggregate payment can then be \nverified on-chain by a payment verifier, reducing the number of transactions and \nsimplifying the payment process.\n\n## Documentation for Individual Components\n\n- [tap_aggregator](tap_aggregator/README.md)\n- [tap_core](tap_core/README.md) - links to this `README` for now.\n\n## Key Components\n\n- **Sender:** Initiates the payment.\n- **Receiver:** Receives the payment.\n- **Signers:** Multiple signers authorized by the sender to sign receipts.\n- **State Channel:** A one-way channel opened by the sender with the receiver \nfor sending receipts.\n- **Receipt:** A record of payment sent by the sender to the receiver.\n- **ReceiptAggregateVoucher (RAV):** A signed message containing the aggregate \nvalue of the receipts.\n- **tap_aggregator:** A service managed by the sender that aggregates receipts \non the receiver's request into a signed RAV.\n- **EscrowAccount:** An account created in the blockchain to hold funds for \nthe sender-receiver pair.\n\n## Security Measures\n\n- The protocol uses asymmetric cryptography (ECDSA secp256k1) to sign and \nverify messages, ensuring the integrity of receipts and RAVs.\n\n## Process\n\n1. **Opening a State Channel:** A state channel is opened via a blockchain \ncontract, creating an EscrowAccount for the sender-receiver pair.\n2. **Sending Receipts:** The sender sends receipts to the receiver through the \nstate channel.\n3. **Storing Receipts:** The receiver stores the receipts and tracks the \naggregate payment.\n4. **Creating a RAV Request:** A RAV request consists of a list of receipts and, \noptionally, the previous RAV.\n5. **Signing the RAV:** The receiver sends the RAV request to the tap_aggregator, \nwhich signs it into a new RAV.\n6. **Tracking Aggregate Value:** The receiver tracks the aggregate value and \nnew receipts since the last RAV.\n7. **Requesting a New RAV:** The receiver sends new receipts and the last RAV \nto the tap_aggregator for a new RAV.\n8. **Closing the State Channel:** When the allocation period ends, the receiver \ncan send the last RAV to the blockchain and receive payment from the EscrowAccount.\n\n## Performance Considerations\n\n- The primary performance limitations are the time required to verify receipts \nand network limitations for sending requests to the tap_aggregator.\n\n## Use Cases\n\n- The TAP protocol is suitable for systems that need unidirectional, parallel \nmicro-payments that are too expensive to redeem individually on-chain. By \naggregating operations off-chain and redeeming them in one transaction, costs \nare drastically reduced.\n\n## Compatibility\n\n- The current implementation is for EVM-compatible blockchains, with most of the \nsystem being off-chain.\n\n## Contributing\n\nContributions are welcome! Please submit a pull request or open an issue to \ndiscuss potential changes.\nAlso, make sure to follow the [Contributing Guide](https://github.com/semiotic-ai/timeline-aggregation-protocol/blob/main/CONTRIBUTING.md).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemiotic-ai%2Ftimeline-aggregation-protocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsemiotic-ai%2Ftimeline-aggregation-protocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemiotic-ai%2Ftimeline-aggregation-protocol/lists"}