{"id":25919706,"url":"https://github.com/txtx/surfpool","last_synced_at":"2025-03-03T15:15:52.360Z","repository":{"id":274874751,"uuid":"924147749","full_name":"txtx/surfpool","owner":"txtx","description":"Surfpool is the best place to train before surfing Solana. ","archived":false,"fork":false,"pushed_at":"2025-02-27T03:19:58.000Z","size":1684,"stargazers_count":27,"open_issues_count":8,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-27T04:25:50.394Z","etag":null,"topics":["blockchain","graphql","infrastructure-as-code","solana","web3"],"latest_commit_sha":null,"homepage":"https://surfpool.run","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/txtx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-01-29T13:59:14.000Z","updated_at":"2025-02-27T03:20:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"7fae75c5-a5f5-49ef-a2d8-6ca34c521e7e","html_url":"https://github.com/txtx/surfpool","commit_stats":null,"previous_names":["txtx/surfpool"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txtx%2Fsurfpool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txtx%2Fsurfpool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txtx%2Fsurfpool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/txtx%2Fsurfpool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/txtx","download_url":"https://codeload.github.com/txtx/surfpool/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241686830,"owners_count":20003112,"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","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":["blockchain","graphql","infrastructure-as-code","solana","web3"],"created_at":"2025-03-03T15:15:51.583Z","updated_at":"2025-03-03T15:15:52.347Z","avatar_url":"https://github.com/txtx.png","language":"Rust","funding_links":[],"categories":["Rust","Developer Tools"],"sub_categories":["Testing Environment"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/txtx/surfpool/main/doc/assets/surfpool-github-hero-dark.png\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/txtx/surfpool/main/doc/assets/surfpool-github-hero-light.png\"\u003e\n      \u003cimg alt=\"Surfpool is the best place to train before surfing Solana\" style=\"max-width: 60%;\"\u003e\n  \u003c/picture\u003e\n\u003c/div\u003e\n\n### TL;DR\n\n`surfpool` is to Solana what `anvil` is to Ethereum: a blazing fast ⚡️ in-memory testnet that has the ability to point-fork Solana mainnet instantly.\n\n## Introduction\n\nSurfpool provides a blazing-fast, developer-friendly simulation of Solana Mainnet that runs seamlessly on your local machine. It eliminates the need for high-performance hardware while maintaining an authentic testing environment.\n\nWhether you're developing, debugging, or educating yourself on Solana, Surfpool gives you an instant, self-contained network that dynamically fetches missing Mainnet data as needed—no more manual account setups.\n\n## Features\n\n- Fast \u0026 Lightweight – Runs smoothly on any machine without heavy system requirements.\n\n- Dynamic Account Fetching – Automatically retrieves necessary Mainnet accounts during transaction execution.\n\n- Anchor Integration – Detects Anchor projects and deploys programs automatically.\n\n- Educational \u0026 Debug-Friendly – Provides clear insights into transaction execution and state changes.\n\n- Easy Installation – Available via Homebrew, Snap, and direct binaries.\n\n## Installation\n\nInstall Surfpool CLI with:\n\n```console\n# macOS (Homebrew)\nbrew install txtx/taps/surfpool\n\n# Linux (Snapstore)\nsnap install surfpool\n```\n\nVerify installation:\n\n```console\nsurfpool --version\n```\n\n## Usage\n\nStart a local Solana network with:\n\n```console\nsurfpool run\n```\n\nIf inside an Anchor project, Surfpool will:\n\n- Automatically generate infrastructure as code (similar to Terraform).\n\n- Deploy your Solana programs to the local network.\n\n- Provide a clean, structured environment to iterate safely.\n\nThe command:\n\n```console\nsurfpool run --help\n```\n\nIs documenting all the options available.\n\n## Crypto Infrastructure as Code: A New Standard in Web3\n\nInfrastructure as code (IaC) transforms how teams deploy and operate Solana programs:\n\n- Declarative \u0026 Reproducible – Clearly defines environments, making deployments consistent.\n\n- Auditable – Security teams can review not just the code of your Solana programs, but the way you will be deploying and operating your protocol.\n\n- Seamless Transition to Mainnet – Test with the exact infrastructure that will go live.\n\nWith Surfpool, every developer learns to deploy Solana programs the right way—scalable, secure, and production-ready from day one.\n\n\n## Architecture \u0026 How to Contribute\n\nSurfpool is built on the low-level solana-svm API, utilizing the excellent LiteSVM wrapper. This approach provides greater flexibility and significantly faster boot times, ensuring a smooth developer experience.\n\nWe are actively developing Surfpool and welcome contributions from the community. If you'd like to get involved, here’s how:\n\n- Explore and contribute to open issues: [GitHub Issues](https://github.com/txtx/surfpool/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22help%20wanted%22)\n\n- Join discussions and collaborate via our [Telegram Channel](https://t.me/surfpool)\n\nYour contributions help shape the future of Surfpool, making it an essential tool for Solana developers worldwide.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftxtx%2Fsurfpool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftxtx%2Fsurfpool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftxtx%2Fsurfpool/lists"}