{"id":28470545,"url":"https://github.com/magicblock-labs/conjunto","last_synced_at":"2025-07-23T21:32:24.003Z","repository":{"id":290792159,"uuid":"797315644","full_name":"magicblock-labs/conjunto","owner":"magicblock-labs","description":"Orchestrating MagicBlock's machinery to abstract away underlying ephemeral validator, write back and proxying","archived":false,"fork":false,"pushed_at":"2025-04-30T14:51:05.000Z","size":303,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-01T17:44:18.877Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/magicblock-labs.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,"zenodo":null}},"created_at":"2024-05-07T15:48:47.000Z","updated_at":"2025-06-26T12:33:44.000Z","dependencies_parsed_at":"2025-04-30T15:57:27.326Z","dependency_job_id":"d0e8cf16-ec41-43e2-ab20-18161b760829","html_url":"https://github.com/magicblock-labs/conjunto","commit_stats":null,"previous_names":["magicblock-labs/conjunto"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/magicblock-labs/conjunto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fconjunto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fconjunto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fconjunto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fconjunto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magicblock-labs","download_url":"https://codeload.github.com/magicblock-labs/conjunto/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fconjunto/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266753678,"owners_count":23979139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":"2025-06-07T09:31:01.198Z","updated_at":"2025-07-23T21:32:23.969Z","avatar_url":"https://github.com/magicblock-labs.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# conjunto\n\nOrchestrating MagicBlock's machinery to abstract away underlying ephemeral validator, write\nback and proxying.\n\n## Director\n\nThe director solves the following problem for all RPC requests that come in and solves it as\nfollows:\n\n- it decides if this request is better served via the ephemeral validator or the chain\n- to make those decisions it considers the accounts involved in the transaction\n- i.e. for `sendTransaction` it makes sure that:\n  - if none of them are delegated, transaction is sent to chain\n  - if all of them are delegated, transaction is sent to ephemeral\n  - in the case of a mix it declares the request as _unroutable_\n- other RPC methods need to be handled similarly, see `director-rpc/src/rpc/passthrough.rs`\n\nFor Pubsub methods it solves this in a different way:\n\n- all messages from the chain and ephemeral backends are routed into the single client socket\n- when the client subscribes those subscriptions are forwarded to the correct backend or both\ndepending on the accounts/signatures involved\n\n## Current Status\n\n### RPC Server\n\n- uses jsonrpsee which causes a bunch of issues, see `director-rpc/src/lib.rs`\n- it also maybe too highlevel and we should consider replacing with a lower level\n  implementation\n\n#### Working Methods\n\n- most methods are just passed through to chain for now, however I noted which strategy they\nshould _actually_ use, see `director-rpc/src/rpc/passthrough.rs`.\n- once we decide if to use jsonrpsee or not we need to implement them\n- they should make use of existing code, i.e. the `guidepoint` crate as much of possible, i.e.\n  if the strategy is based on an account being present in the ephemeral validator\n\n### Cors Support\n\n- tried to add CORS support but ran into jsonrpsee issue, not worth investing more time until\nwe decide if we keep that module or go lower level\n\n### Pubsub Server\n\n- correctly guides all subscriptions by looking at method and accounts/signatures involved\n- I'd consider this done at this point and am happy with the fairly low level approach\n- CORS support may need to be added if we see issues in the browser\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicblock-labs%2Fconjunto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagicblock-labs%2Fconjunto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicblock-labs%2Fconjunto/lists"}