Etherfuse Asset Yield Oracle

This contract implementation is fully compatible with SEP-40 ecosystem standard. Check the standard for general info and public consumer interface documentation.

Building the Contracts

Prerequisites

• Ensure you have Rust installed and set up on your local machine. Follow the official guide here.
• Install the stellar cli client. (Version used for this was 23.1.4)
• Get the Yield Oracle Devnet Keypair from the Blend Pool wallet in 1Password, and add a stellar key named blend-test-net or blend-main-net depending on which environment you are interacting with.

Deploying

• For testnet, run make deploy-testnet. This will make a NEW contract. If you want to modify the existing testnet contract, run make update-testnet

Initial Configurations

• Testnet Asset Contracts (Order matters!)

1. USTRY (CCUGMX7HX6CH6T4XNPALQ7HCVU37RLUNHAYNSAIALTPFHFQVIRIHALBC)
2. CETES (CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC)

• Mainnet Asset Contracts

1. USTRY (CBLV4ATSIWU67CFSQU2NVRKINQIKUZ2ODSZBUJTJ43VJVRSBTZYOPNUR)
2. CETES (CAL6ER2TI6CTRAY6BFXWNWA7WTYXUXTQCHUBCIBU5O6KM3HJFG6Z6VXV)
3. TESOURO (CD6M4R2322BYCY2LNWM74PEBQAQ63SA3DUJLI3L4225U4ZVCLMSCBCIS)

• Testnet was configured like so

stellar contract invoke --id $TESTNET_CONTRACT_ID -- config --config '{"admin":"GBH62ESUWAJGVIDWMQTIJ4T24IWIGMYM2LGGVCBZGAZY7EYHDYMMA7HX", "base_asset":{"Other":"USD"}, "decimals": 14, "fx_oracle_address
": "CCSSOHTBL3LEWUCBBEB5NJFC2OKFRC74OWEIJIZLRJBGAAU4VMU5NV4W", "max_yield_deviation_percent": 1, "period": 86400000, "resolution": 300000}'

• Afterwards, assets were added with matching FX symbols like so:

stellar contract invoke --id $TESTNET_CONTRACT_ID -- add_assets --fxs '["USD","MXN"]' --assets '[{"Stellar":"CCUGMX7HX6CH6T4XNPALQ7HCVU37RLUNHAYNSAIALTPFHFQVIRIHALBC"},{"Stellar":"CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC"}]'

Testing methods

Use the stellar CLI to execute methods on the contract. Set your network to testnet using stellar network use testnet.

stellar contract invoke --id $TESTNET_CONTRACT_ID -- <instruction_name>

You can use the --help param to see how to pass the variables for any given instruction.

stellar contract invoke --id $TESTNET_CONTRACT_ID -- <instruction_name> --help

You usually need to wrap JSON in single quotes, and be sure to wrap property names in double quotes

Testing

Running Tests

This project uses mise for task management. All dependencies will be automatically installed via mise.

# Install all tools (rust, cargo-llvm-cov, etc.)
mise install

# Run all tests
mise run test
# or use the alias
mise run t

# Run tests with coverage
mise run coverage
# or use the alias
mise run cov

# Run tests with coverage and view HTML report
mise run coverage-open
# or use the alias
mise run cov-open

Code Coverage

This project uses cargo-llvm-cov for code coverage. It's automatically installed via mise.

Available Coverage Commands:

• mise run coverage (alias: cov) - Run tests with coverage summary
• mise run coverage-html (alias: cov-html) - Generate HTML coverage report
• mise run coverage-open (alias: cov-open) - Generate and open HTML coverage report in browser
• mise run coverage-check (alias: cov-check) - Check if coverage meets minimum threshold (default 80%)
• mise run coverage-lcov (alias: cov-lcov) - Generate LCOV report for CI/CD

Customize Coverage Threshold:

MIN_COVERAGE=90 mise run coverage-check

Available Tasks

View all available tasks:

mise tasks

Build & Deploy:

• mise run build-testnet - Build contract for testnet
• mise run deploy-testnet - Deploy contract to testnet
• mise run update-testnet - Update existing testnet contract

CI/CD

The GitHub Actions workflow runs tests with coverage on every push and pull request. The workflow:

• Runs all tests with coverage
• Enforces minimum coverage threshold (80%)
• Uploads coverage reports as artifacts
• (Optional) Uploads to Codecov if configured