@sodalabs/bubble-core-contracts

Solidity import package for Bubble app contracts.

App creators install this package and import the Solidity sources directly from node_modules. There is no copy step, sync script, generated address file, or JavaScript helper.

Install

Install straight from the repository:

npm install github:soda-mpc/bubble-core-contracts

Usage

Import the app-facing contracts directly:

import "@sodalabs/bubble-core-contracts/contracts/bubble/MpcCore.sol";
import "@sodalabs/bubble-core-contracts/contracts/bubble/DecryptionCaller.sol";

Network-specific Bubble core addresses are selected inside the Solidity package by block.chainid through contracts/bubble/BubbleAddresses.sol. The same app contract source can be compiled and deployed to multiple supported networks without changing imports or package configuration.

Supported Chains

contracts/bubble/BubbleAddresses.sol resolves addresses for:

Network	Chain ID
Ethereum mainnet	1
Arbitrum One	42161
Polygon	137
Sepolia	11155111
Arbitrum Sepolia	421614

Unsupported chains revert with UnsupportedBubbleChain(chainId).

Layout

• contracts/bubble/BubbleAddresses.sol - on-chain address registry keyed by block.chainid
• contracts/bubble/MpcInterface.sol - interfaces for deployed Bubble core contracts
• contracts/bubble/MpcCore.sol - app library for Bubble operations
• contracts/bubble/DecryptionCaller.sol - helper base contract for decryption callbacks

This package intentionally has no main, exports, or runtime JavaScript API. It is consumed through Solidity imports.

Versioning

Bump version in package.json when you cut a release.

License

Apache License 2.0. See LICENSE and NOTICE.