Sphinx core library
npm install @hujw77/coreSphinx is an automated smart contract deployment platform for Foundry. Key features include gasless deployments, one-click multi-chain deployments, and deployments in CI. You can integrate Sphinx with minimal changes to your existing Forge scripts.
Deployments with Sphinx are a three-step process:
1. Propose: Initiate the deployment from your command line or CI process by submitting the transactions to Sphinx's backend.
2. Approve: Your Gnosis Safe owner(s) approve the deployment by signing a single meta transaction in the Sphinx UI.
3. Execute: Sphinx's backend trustlessly executes the deployment through your Gnosis Safe.
* Gasless Deployments: You don't need to worry about securing a funded private key or getting native gas tokens on any chain. We'll bill you in fiat after your deployment is finished. Deployments on testnets are completely free.
* One-Click Multichain Deployments: Approve deployments across dozens of networks by signing a single meta transaction. Sphinx's backend will deploy on each network in parallel and verify your smart contracts on block explorers.
* Deployments in CI: Eliminate human error and improve security by gaslessly triggering deployments from your CI process. You can always propose from your local machine if you'd prefer.
* Deploy via Gnosis Safe: The Sphinx protocol is a Gnosis Safe Module designed for deployments. With the Sphinx Module, your Gnosis Safe owners can approve multi-chain deployments by signing a single meta transaction. Sphinx will deploy a Gnosis Safe on your behalf at a consistent address using CREATE2.
* Trustless: It's impossible to execute anything your Gnosis Safe owners have not explicitly approved. Spearbit has audited our system; see our audit report here.
* Compatible with Forge Scripts: You can integrate Sphinx by adding a few lines of code to your existing Forge scripts.
* Deployment Artifact Management: Sphinx generates and stores deployment artifacts, which can be retrieved at any time.
* Contract Verification: Sphinx automatically verifies contracts on block explorers with no configuration necessary.
* No Lock-In: You can execute deployments from your local machine without using the Sphinx DevOps Platform. These deployments are executed in the exact same manner as they would be executed with the DevOps Platform, including identical contract addresses. This includes networks that the DevOps Platform doesn't currently support.
Sphinx is currently invite-only. Request access on our website.
Pricing for the DevOps Platform is on the website's landing page.
Sphinx does not charge for the Deploy CLI Command, which executes the deployment from your local machine without using the DevOps Platform. However, since it doesn't use the DevOps Platform, you'll need native gas tokens for the deployment.
A demo of the DevOps Platform is on the website's landing page.
- Getting Started in a New Repository
- Getting Started with an Existing Foundry Project
- Writing Deployment Scripts
- CLI Propose Command
- Propose in CI
- Configuration Options
- Deploy from the CLI
- Troubleshooting
- FAQ
- Architecture Overview
- Introduction
- Sphinx Merkle Tree
- SphinxModuleProxy Contract
- SphinxModuleProxyFactory Contract
- ManagedService Contract
- You cannot deploy libraries.
- You can only use the Deploy CLI Command on live networks if your Gnosis Safe has a single owner. (Deployments with the DevOps Platform support an arbitrary number of owners).
- Use existing Gnosis Safes with Sphinx.
- Pay for deployments with USDC on the DevOps Platform.
Please feel free to reach out to us in our Discord to request a feature!
> Note: You can use the Deploy CLI Command to deploy on networks that the DevOps Platform doesn't currently support.
- Ethereum
- BNB Smart Chain (aka BSC)
- Gnosis Chain
- Base
- Scroll
- Mantle
- Darwinia
- Crab
- Astar zkEVM
- Arbitrum
- Blast
- Polygon
- Moonbeam
- Morph
Test networks:
- Ethereum Sepolia
- Arbitrum Sepolia
- Darwinia Pangolin
- Tanssi Pangoro
- Taiko Hekla
More networks are on the way! Please reach out to us in our Discord if there are networks you'd like us to add.
@rpate97\
@sam-goldman\
@smartcontracts\
Wonderland
Contributions to Sphinx are greatly appreciated! Please read our contributing guide to get started. Then, check out the list of Good First Issues. Let us know if you have any questions!
If you have any questions or feature requests, send us a message in our Discord!
We use the Gnosis Safe contracts as a library. These contracts are licensed under LGPL v3. You can access them in Gnosis Safe's repository.
All other code in this repository is licensed under MIT.