One-time setup. Records the admin and unpauses the contract.
fn initialize(
env: soroban_sdk::Env,
admin: soroban_sdk::Address,
) -> Result<(), soroban_sdk::Error>Lock total_amount of token into a new envelope and return its id.
Auth: requires the sender's signature. The same authorization covers the
inner SAC transfer(sender -> contract).
fn create_envelope(
env: soroban_sdk::Env,
sender: soroban_sdk::Address,
token: soroban_sdk::Address,
total_amount: i128,
total_slots: u32,
secret_hash: soroban_sdk::BytesN<32>,
expiry: u64,
split: SplitMode,
) -> ResultClaim one slot of an envelope by revealing the secret preimage.
Returns the amount transferred to recipient (minor units).
Auth: requires the recipient's signature (binds the payout to them).
fn claim(
env: soroban_sdk::Env,
envelope_id: u64,
recipient: soroban_sdk::Address,
preimage: soroban_sdk::Bytes,
) -> ResultAfter expiry, the sender reclaims the unclaimed remainder.
fn refund(env: soroban_sdk::Env, envelope_id: u64) -> Resultfn get_envelope(
env: soroban_sdk::Env,
envelope_id: u64,
) -> Resultfn has_claimed(
env: soroban_sdk::Env,
envelope_id: u64,
recipient: soroban_sdk::Address,
) -> boolfn total_envelopes(env: soroban_sdk::Env) -> u64fn is_paused(env: soroban_sdk::Env) -> boolfn get_admin(env: soroban_sdk::Env) -> Resultfn pause(env: soroban_sdk::Env) -> Result<(), soroban_sdk::Error>fn unpause(env: soroban_sdk::Env) -> Result<(), soroban_sdk::Error>fn set_admin(
env: soroban_sdk::Env,
new_admin: soroban_sdk::Address,
) -> Result<(), soroban_sdk::Error>Replace the contract's own code (admin-gated). Enables shipping fixes without migrating escrow state — important for a mainnet (L6) deploy.
fn upgrade(
env: soroban_sdk::Env,
new_wasm_hash: soroban_sdk::BytesN<32>,
) -> Result<(), soroban_sdk::Error>