{"id":20597020,"url":"https://github.com/tradle/tradle-cordapp","last_synced_at":"2026-04-22T04:31:14.687Z","repository":{"id":66294795,"uuid":"119701945","full_name":"tradle/tradle-cordapp","owner":"tradle","description":null,"archived":false,"fork":false,"pushed_at":"2018-03-06T23:00:45.000Z","size":1195,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-06T15:18:38.964Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tradle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-31T15:01:17.000Z","updated_at":"2021-06-22T22:11:10.000Z","dependencies_parsed_at":"2023-02-25T23:00:12.210Z","dependency_job_id":null,"html_url":"https://github.com/tradle/tradle-cordapp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tradle/tradle-cordapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tradle%2Ftradle-cordapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tradle%2Ftradle-cordapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tradle%2Ftradle-cordapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tradle%2Ftradle-cordapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tradle","download_url":"https://codeload.github.com/tradle/tradle-cordapp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tradle%2Ftradle-cordapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32120857,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"online","status_checked_at":"2026-04-22T02:00:05.693Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-16T08:19:53.229Z","updated_at":"2026-04-22T04:31:14.667Z","avatar_url":"https://github.com/tradle.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Tradle Corda Adapter\n\nThis CorDapp is an adapter for [Tradle](https://github.com/tradle). It is used for sealing authenticated pieces of data in time, and sharing them with third parties.\n\n*Forked from the [CorDapp Java template](https://github.com/corda/cordapp-template-java)*\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n**Table of Contents**\n\n- [Configuration](#configuration)\n- [Moving Parts Overview](#moving-parts-overview)\n  - [Flows](#flows)\n  - [Contract](#contract)\n  - [State](#state)\n  - [Vault Client](#vault-client)\n  - [REST API](#rest-api)\n    - [GET /api/share/items](#get-apishareitems)\n    - [GET /api/share/unresolved](#get-apishareunresolved)\n    - [POST /api/share/item](#post-apishareitem)\n    - [POST /api/share/resolveparty](#post-apishareresolveparty)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## Configuration\n\nbuild.gradle is configured to launch 3 nodes (Party A, B, C)\n\nthe webservers for these nodes live at 10007, 10010, 10013 respectively\n\n## Moving Parts Overview\n\n### Flows\n\n- create \"shared item\" [initiator flow](https://github.com/tradle/tradle-cordapp/blob/master/cordapp/src/main/java/com/template/SharedItemCreateFlow.java): If the counterparty doesn't have a Corda node yet, saves a toTmpId (Tradle identity hash), to be resolved later. Otherwise creates state with two parties (see responder flow)\n\n- create \"shared item\" [responder flow](https://github.com/tradle/tradle-cordapp/blob/master/cordapp/src/main/java/com/template/CreateFlowResponder.java) (if counterparty already has a corda node): checks if has data identified by \"link\", e.g. in some external database. If so, confirms state creation\n\n- resolve identity [initiator flow](https://github.com/tradle/tradle-cordapp/blob/master/cordapp/src/main/java/com/template/ResolveToIdentityFlow.java): resolve toTmpId to Corda party in all shared items, i.e. updates state objects with `toTmpId == [given toTmpId]` with `to = [given Corda Party]`\n\n### Contract\n\n(state change validation)\n\n[Contract code](./cordapp-contracts-states/src/main/java/com/template/SharedItemContract.java)\n\n### State\n\n[Code](https://github.com/tradle/tradle-cordapp/blob/master/cordapp-contracts-states/src/main/java/com/template/SharedItemState.java)\n\n### Vault Client\n\n(RPC calls, used by REST API module)\n\n[Code](https://github.com/tradle/tradle-cordapp/blob/master/cordapp/src/main/java/com/template/SharedItemClient.java)\n\n### REST API\n\n[Code](https://github.com/tradle/tradle-cordapp/blob/master/cordapp/src/main/java/com/template/SharedItemApi.java)\n\n#### GET /api/share/items\n  @HeaderParam(\"Authorization\")  \n  @QueryParam(\"link\")  \n  @QueryParam(\"from\")  \n  @QueryParam(\"to\")  \n  @QueryParam(\"toTmpId\")  \n  @QueryParam(\"timestamp\")\n\nList shared items. Optionally filter by adding conditions via query parameters\n\nexamples: \n\n```sh\ncurl -H \"Authorization: abc\" http://localhost:10007/api/share/items\ncurl -H \"Authorization: abc\" http://localhost:10007/api/share/items?link=link1\n```\n\n#### GET /api/share/unresolved\n  @HeaderParam(\"Authorization\")  \n  @QueryParam(\"partyTmpId\")\n\nList items with unresolved counterparties\n\nexamples: \n\n```sh\ncurl -H \"Authorization: abc\" http://localhost:10007/api/share/unresolved\ncurl -H \"Authorization: abc\" \"http://localhost:10007/api/share/unresolved?partyTmpId=joe\"\n```\n\n#### POST /api/share/item\n  @HeaderParam(\"Authorization\")  \n  @FormParam(\"link\")  \n  @FormParam(\"partyName\")  \n  @FormParam(\"partyTmpId\")  \n\nCreate a record for an item with an unresolved counterparty\n\nFor ease of testing, API keys currently reside in a text file in resources/certificates/apikeys.txt (and is \"abc\" per the examples)\n\nexamples: \n\n```sh\ncurl -X POST -H 'Authorization: abc' --data \"partyName=O%3DPartyA%2CL%3DLondon%2CC%3DGB\u0026partyTmpId=b57ed7f459ea6d0438de3841802110dfd1ce881d78909c9f0f69e19614cf574f\" http://localhost:10007/api/share/item\n```\n\n#### POST /api/share/resolveparty\n  @HeaderParam(\"Authorization\")  \n  @FormParam(\"partyTmpId\")  \n  @FormParam(\"partyName\")  \n\nResolve a partyTmpId to a partyName\n\nexamples: \n\n```sh\ncurl -X POST -H \"Authorization: abc\" --data \"partyName=O%3DPartyB%2CL%3DNew%20York%2CC%3DUS\u0026partyTmpId=b57ed7f459ea6d0438de3841802110dfd1ce881d78909c9f0f69e19614cf574f\" http://localhost:10007/api/share/resolveparty\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftradle%2Ftradle-cordapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftradle%2Ftradle-cordapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftradle%2Ftradle-cordapp/lists"}