Skip to content

Allow miners to post direction specific rates#7

Open
LandynDev wants to merge 4 commits intotestfrom
feat/direction-specific-rates
Open

Allow miners to post direction specific rates#7
LandynDev wants to merge 4 commits intotestfrom
feat/direction-specific-rates

Conversation

@LandynDev
Copy link
Copy Markdown
Collaborator

@LandynDev LandynDev commented Apr 1, 2026

Summary

Miners post a single bilateral rate that applies to both swap directions. But tx fees are asymmetric across chains — sending BTC costs more than receiving it. A single rate forces miners to average out that cost, meaning users get a worse rate on the cheap direction.

This adds direction-specific rates so miners can price each direction honestly (e.g., 340 TAO/BTC for BTC->TAO, 350 TAO/BTC for TAO->BTC). The spread captures the tx fee differential.

Approach

Commitment format bumped to v3 with two rate fields. The correct rate is selected based on swap direction at initiation time. The entire backend (validator verification, miner fulfillment, smart contract, voting) is unchanged — each swap on-chain still stores one rate, it's just the right one for that direction now.

Test plan

  • 54/54 unit tests pass (17 new commitment parsing tests including normalization proof)
  • Lint clean (ruff format + check)
  • E2E suite 02: 21/21 pass (full swap lifecycle)
  • Manual CLI verification of all directional rate flows

Reviewer experience

Start the dev environment and explore these flows:

Post a pair with directional rates (as miner):

alw --network local --netuid 2 --wallet.name test-miner-1 --wallet.hotkey test-miner-1 \
  miner post btc <btc_addr> tao <tao_addr> 340 360

Post same rate both ways:
alw --network local --netuid 2 --wallet.name test-miner-1 --wallet.hotkey test-miner-1 \
  miner post btc <btc_addr> tao <tao_addr> 345

Check miner status shows both rates:
alw --network local --netuid 2 --wallet.name test-miner-1 --wallet.hotkey test-miner-1 miner status

View rates as a user (separate columns per direction):
alw --network local --netuid 2 view rates
alw --network local --netuid 2 view miners

Initiate swap and verify correct rate is used:
alw --network local --netuid 2 --wallet.name test-user --wallet.hotkey test-user swap now
# Choose BTC->TAO → should show rate 340
# Choose TAO->BTC → should show rate 360

A miner could claim a third-party tx to the user's dest address as their
own fulfillment. Store miner_dest_address on the swap struct at initiation
and validate tx_info.sender against it during dest-side verification.
Miners can now post separate rates for each swap direction (e.g., 340 TAO/BTC
for BTC->TAO, 350 TAO/BTC for TAO->BTC) to capture tx fee asymmetry. Commitment
format bumped to v3 with two rate fields. Backend unchanged — each swap still
stores one rate, selected by direction at initiation time.
anderdc
anderdc previously approved these changes Apr 3, 2026
Copy link
Copy Markdown
Collaborator

@anderdc anderdc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Replace TAO-centric assumptions with canonical chain ordering so
any pair (including non-TAO pairs like BTC-ETH) works correctly.
TAO is preferred as the rate denomination when present, otherwise
alphabetical ordering is used as a deterministic fallback.

- Add canonical_pair() to chains.py with TAO-preference ordering
- Rename rate_reverse → counter_rate across all files
- Change get_rate_for_direction(source_is_tao) to accept chain name
- Rename rate.py params: source_is_tao → is_reverse, tao_decimals/asset_decimals → dest_decimals/source_decimals
- Filter miners with rate=0 for the desired direction (CLI + validator)
- Fix test_scale.py swap encoding (missing miner_source_address, miner_dest_address, rate)
- Fix float comparison for rate display → use string comparison
- Add 5 unit tests: canonical_pair, direction after normalization, direction-specific rate calc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants