Skip to content

deployment.md

Latest commit

 

History

History
113 lines (79 loc) · 6.48 KB

deployment.md

File metadata and controls

113 lines (79 loc) · 6.48 KB
Raw

Deployment

The escrow's code and economic rules cannot change after deployment. The owner can later replace the settler and the treasury and change which tokens new campaigns may use (see owner actions).

Base Mainnet

Requirements: a funded deployer account (Foundry keystore, hardware wallet or other signer), the owner, settler and treasury addresses, and an Etherscan API key for source verification. The owner and the settler should be separate wallets with their keys on hardware signers. The deployer account gets no role in the contract.

export OWNER=0x...              # Morcast owner wallet
export SETTLER=0x...            # Morcast settler wallet
export TREASURY=0x...           # Morcast fee recipient
export ETHERSCAN_API_KEY=...    # for --verify

forge script script/Deploy.s.sol \
  --rpc-url https://mainnet.base.org \
  --account <keystore-name> \
  --broadcast --verify

On Base mainnet the script always uses the canonical tokens. USDC and MOR may be left unset. If set, they must equal these addresses:

Token Address
USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
MOR 0x7431aDa8a591C955a994a21710752EF9b882b8e3

After deployment, check:

  • The code hash (cast codehash <escrow>) equals the SDK's ESCROW_CODE_HASH, so the deployment runs the released code.
  • owner(), settler() and treasury() return the intended addresses, and pendingOwner() returns the zero address.
  • isCampaignToken(USDC) and isCampaignToken(MOR) return true, creationPaused() returns false, and VERSION() returns the released version.
  • SETTLEMENT_OPENS_AFTER() returns 432000 (5 days), SETTLEMENT_CLOSES_AFTER() returns 864000 (10 days) and MAX_CAMPAIGN_DURATION() returns 7776000 (90 days).
  • The source is verified on Basescan.

Other Networks

On every chain except Base mainnet, both token addresses are required:

export OWNER=0x... SETTLER=0x... TREASURY=0x... USDC=0x... MOR=0x...
forge script script/Deploy.s.sol --rpc-url <rpc-url> --account <keystore-name> --broadcast

Test Builds With Short Days

A whole campaign takes about two weeks with real days, from the request to the settlement window. To run one in about an hour on a test network, scripts/deploy-short-days.sh deploys a test build whose campaign days last DAY_SECONDS seconds. Settlement opens after 5 of those days and closes after 10, and a campaign lasts at most 90. The rest of the code is the same.

export OWNER=0x... SETTLER=0x... TREASURY=0x... USDC=0x... MOR=0x...
RPC_URL=https://sepolia.base.org DAY_SECONDS=300 \
  scripts/deploy-short-days.sh --account <keystore-name> --broadcast

The script builds the test build in a temporary copy of the project, so src never changes. Its code hash differs from ESCROW_CODE_HASH, so isGenuineEscrow answers false for it, and it must never hold real funds. The script refuses Base mainnet. Check the build with SETTLEMENT_OPENS_AFTER(), which returns 5 × DAY_SECONDS. Morcast's platform accepts a test build only on a test network whose campaign day has the same length.

Local Development

anvil

forge script script/DeployLocal.s.sol \
  --rpc-url http://127.0.0.1:8545 \
  --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 \
  --broadcast

The private key is Anvil's default account 0. The script:

  • deploys mock USDC (6 decimals) and mock MOR (18 decimals), plus an escrow that accepts them
  • mints 1,000,000 of each token to the brand account
  • uses Anvil account 0 (the deployer) as owner, account 1 as settler, account 2 as treasury and account 3 as brand, unless OWNER, SETTLER, TREASURY or BRAND is set
  • refuses to run on any chain other than Anvil (chain ID 31337).

On a fresh Anvil node, the addresses are always:

Contract Address
USDC (mock) 0x5FbDB2315678afecb367f032d93F642f64180aa3
MOR (mock) 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
MorcastEscrow 0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0

Deployments

Production on Base

Production (Base, chain 8453) runs version 1.0.0, deployed from v1.0.0 on 13 October 2026. Its source is verified on Sourcify with an exact match, and its code hash is the release's ESCROW_CODE_HASH. Its transaction is recorded in broadcast/Deploy.s.sol/8453:

Contract or role Address
MorcastEscrow 0x97f3Db60394c979c5ffB1345b62BDC3020Fb0459, created in block 52554940
Owner 0x97A695618897dd276502Bb9b7a25D088f1b91A02
Settler and treasury 0x7Fb845e53fd656754E06e1A92d30eD6B221d4401
USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
MOR 0x7431aDa8a591C955a994a21710752EF9b882b8e3

The owner and the settler are separate wallets Morcast holds. The treasury is the settler, so the protocol fee goes to the settler wallet. The account that sent the deployment, 0xB0742AC9890BEf1894747724077254F9553Cd946, has no role in the contract.

That account also sent the first staging deployment below. A contract's address follows from its sender and the sender's transaction count, so this escrow has on Base the address the test MOR token has on Base Sepolia. They are different contracts on different chains.

Staging on Base Sepolia

Staging (Base Sepolia, chain 84532) runs version 1.0.0, deployed from v1.0.0-rc.4 and verified on Sourcify. Its transactions are recorded in broadcast/Deploy.s.sol/84532:

Contract Address
MorcastEscrow 0xc55610A27218cdD8A8221fA404b059A9D8d8e96D, created in block 47939959
USDC 0x036CbD53842c5426634e7929541eC2318f3dCF7e (Circle's test USDC)
MOR (test) 0x97f3Db60394c979c5ffB1345b62BDC3020Fb0459: MockERC20 "MorpheusAI (test)", 18 decimals. Anyone can mint it

Its owner, settler and treasury are one staging operator account, 0xB0742AC9890BEf1894747724077254F9553Cd946, which holds no real funds.

An earlier deployment, made from v1.0.0-rc.3 before the contract took its present name, stays at 0x7550A4093bF8883Faa437bd60DA4a7eC3591a1D7, created in block 47781042. Its code hash is that release's. Morcast sends it no new campaigns, and it keeps serving the ones it holds.