Methods and Manifests

This page documents all methods available in the Liquify smart contract. Always interact through the Interface Component for stability.

Instant Unstaking Methods

liquify_unstake

Instantly converts LSUs to XRD using available liquidity.

Signature

pub fn liquify_unstake(
    &mut self, 
    lsu_bucket: FungibleBucket, 
    max_iterations: u8
) -> (Bucket, FungibleBucket)

Parameters

lsu_bucket - LSUs from any Radix validator

Minimum value: 0 XRD worth (configurable)
Maximum value: 10,000,000 XRD worth (configurable)
Must be native Radix validator LSU

max_iterations - Maximum liquidity positions to check

Recommended: 25-30 for typical orders
Maximum effective: ~50 (gas constraints)
Higher = better price but more gas
Each iteration: ~0.02 XRD gas cost

Returns

(Bucket, FungibleBucket) - Tuple containing:

XRD received (after discounts and fees)
Remaining LSUs if liquidity exhausted

Order Matching Logic

Iterates through liquidity positions by best discount first
Fills orders at progressively worse discounts
Stops when LSUs exhausted or iteration limit reached
Small orders (<1,000 XRD) only match non-automated positions

Platform Fee

0.05% deducted from XRD output
Applied after discount calculation

liquify_unstake Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw"
    Address("resource_tdx_2_1thx59p0wau0nqcp4ux96lupk7epnf8l8crcfpsv3s8hc2duy9zsspv")
    Decimal("100")
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1thx59p0wau0nqcp4ux96lupk7epnf8l8crcfpsv3s8hc2duy9zsspv")
    Bucket("lsu_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "liquify_unstake"
    Bucket("lsu_bucket")
    25u8
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

liquify_unstake_off_ledger

Unstakes using pre-computed order matching for optimal rates.

Signature

pub fn liquify_unstake_off_ledger(
    &mut self, 
    lsu_bucket: FungibleBucket, 
    order_keys: Vec<u128>
) -> (Bucket, FungibleBucket)

Parameters

lsu_bucket - LSUs to unstake

Same limits as liquify_unstake
Must be native Radix validator LSU

order_keys - Pre-computed AVL tree keys

Source: From indexer or get_raw_buy_list_range
Order: Best discount first for optimal pricing
Format: 128-bit unsigned integers
Invalid keys are skipped silently

Returns

(Bucket, FungibleBucket) - Tuple containing:

XRD received (after discounts and fees)
Remaining LSUs if liquidity exhausted

Advantages Over On-Ledger

No iteration limit (can check 100+ positions)
Optimal price discovery via off-chain computation
More gas efficient for large orders
Deterministic execution

liquify_unstake_off_ledger Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw"
    Address("resource_tdx_2_1thx59p0wau0nqcp4ux96lupk7epnf8l8crcfpsv3s8hc2duy9zsspv")
    Decimal("100")
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1thx59p0wau0nqcp4ux96lupk7epnf8l8crcfpsv3s8hc2duy9zsspv")
    Bucket("lsu_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "liquify_unstake_off_ledger"
    Bucket("lsu_bucket")
    Array<U128>(
        340282366920938463463374607431768211456u128,
        340282366920938463463374607431768211457u128,
        340282366920938463463374607431768211458u128
    )
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

Liquidity Provider Methods

add_liquidity

Deposits XRD to provide liquidity for instant unstaking.

Signature

pub fn add_liquidity(
    &mut self, 
    xrd_bucket: Bucket, 
    discount: Decimal, 
    auto_unstake: bool, 
    auto_refill: bool, 
    refill_threshold: Decimal,
    automation_fee: Decimal
) -> NonFungibleBucket

Parameters

xrd_bucket - Bucket containing XRD tokens

Minimum: 10,000 XRD (configurable with owner badge)
Maximum: No limit

discount - Discount rate as decimal (not percentage)

Range: 0.00 to 0.05 (0% to 5%)
Increments: 0.00025 (0.025% steps)
Example: 0.01 = 1% discount

auto_unstake - Enable automatic unstaking of received LSUs

true: LSUs are immediately unstaked and fills are returned as stake claim NFTs
false: LSUs are held for manual collection

auto_refill - Enable automatic liquidity refilling

Requires: auto_unstake must be true
true: Claimable XRD automatically re-adds to liquidity when another use calls the
false: Manual processing required

refill_threshold - Minimum XRD to trigger auto-refill

Minimum: 10,000 XRD (configurable by admin)
Must be less than total position value
Recommended: 50-90% of position size

automation_fee - XRD fee for automation processors

Recommended: 5-10 XRD
Higher fees = more incentive for others to help automate liquidity
Paid per automation cycle

Returns

NonFungibleBucket - Liquidity Receipt NFT tracking your position

add_liquidity Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw"
    Address("resource_tdx_2_1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxtfd2jc")
    Decimal("50000")
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxtfd2jc")
    Bucket("xrd_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "add_liquidity"
    Bucket("xrd_bucket")
    Decimal("0.01")
    true
    true
    Decimal("20000")
    Decimal("7")
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

increase_liquidity

Adds more XRD to an existing liquidity position.

Signature

pub fn increase_liquidity(
    &mut self, 
    receipt_bucket: Bucket, 
    xrd_bucket: Bucket
) -> Bucket

Parameters

receipt_bucket - Your Liquidity Receipt NFT

Must contain exactly one NFT
NFT must be from this Liquify instance

xrd_bucket - Additional XRD to add

Current + new must be ≥ minimum liquidity (10,000 XRD)
No maximum limit

Returns

Bucket - The same Liquidity Receipt NFT

Effects

Position moves to back of queue at same discount level
Maintains all automation settings

increase_liquidity Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw_non_fungibles"
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#")
    )
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw"
    Address("resource_tdx_2_1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxtfd2jc")
    Decimal("20000")
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxtfd2jc")
    Bucket("xrd_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "increase_liquidity"
    Bucket("receipt_bucket")
    Bucket("xrd_bucket")
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

remove_liquidity

Withdraws available XRD from liquidity position(s).

Signature

pub fn remove_liquidity(
    &mut self, 
    liquidity_receipt_bucket: Bucket
) -> (Bucket, Bucket)

Parameters

liquidity_receipt_bucket - One or more Liquidity Receipt NFTs

Can process multiple receipts in one transaction
Only available liquidity is withdrawn

Returns

(Bucket, Bucket) - Tuple containing:

XRD withdrawn from all positions
Receipt NFTs returned

Effects

Only withdraws available liquidity (not in active orders)
Removes positions from order queue
Disables auto_refill if enabled
Fills for this receipt must be collected separately

remove_liquidity Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw_non_fungibles"
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#"),
        NonFungibleLocalId("#456#")
    )
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "remove_liquidity"
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

collect_fills

Collects LSUs or stake claim NFTs from filled orders.

Signature

pub fn collect_fills(
    &mut self, 
    liquidity_receipt_bucket: Bucket, 
    number_of_fills_to_collect: u64
) -> (Vec<Bucket>, Bucket)

Parameters

liquidity_receipt_bucket - One or more Liquidity Receipt NFTs

Processes receipts sequentially
Stops when fill limit reached

number_of_fills_to_collect - Maximum fills to process

Recommended: 50-100
Each fill costs: ~0.03 XRD gas
Applies across all receipts

Returns

(Vec<Bucket>, Bucket) - Tuple containing:

Vector of collected asset buckets
Receipt NFTs returned unchanged

Collected Assets

If auto_unstake=false: Original LSUs
If auto_unstake=true: Stake claim NFTs (unstake receipts)

Multi-Receipt Processing

Processes receipts in order provided
Continues until limit reached
May partially process last receipt

collect_fills Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw_non_fungibles"
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#"),
        NonFungibleLocalId("#456#")
    )
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "collect_fills"
    Bucket("receipt_bucket")
    50u64
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

Automation Methods

cycle_liquidity

Processes automated liquidity refills for eligible positions.

Signature

pub fn cycle_liquidity(
    &mut self, 
    receipt_ids: Vec<NonFungibleLocalId>
) -> FungibleBucket

Parameters

receipt_ids - NFT IDs to process

Format: Include hashes (e.g., "#123#")
Maximum recommended: 5-10 per transaction
Order: Process highest fee positions first

Returns

FungibleBucket - Collected automation fees in XRD

Processing Logic

Checks each receipt for eligibility:
- auto_refill must be enabled
- Claimable XRD ≥ refill_threshold
- Has claimable fills (past unbonding)
Claims all XRD from stake claims
Deducts automation fee
Re-adds remaining XRD to liquidity
Moves position to back of queue

Iteration Limits

Max fills per cycle: 50 (configurable by admin)
Processes receipts sequentially
Skips receipts that can't be fully processed
Exception: First receipt can be partially processed

cycle_liquidity Manifest

CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "cycle_liquidity"
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#"),
        NonFungibleLocalId("#456#"),
        NonFungibleLocalId("#789#"),
        NonFungibleLocalId("#1011#"),
        NonFungibleLocalId("#1213#")
    )
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

update_auto_refill_status

Toggles auto-refill for a position.

Signature

pub fn update_auto_refill_status(
    &mut self, 
    receipt_bucket: Bucket, 
    auto_refill: bool
) -> Bucket

Parameters

receipt_bucket - Single Liquidity Receipt NFT

auto_refill - New status

Can only enable if auto_unstake=true
Disabling removes from automation queue

Returns

Bucket - The same Receipt NFT

update_auto_refill_status Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw_non_fungibles"
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#")
    )
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "update_auto_refill_status"
    Bucket("receipt_bucket")
    true
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

update_refill_threshold

Changes refill threshold for a position.

Signature

pub fn update_refill_threshold(
    &mut self, 
    receipt_bucket: Bucket, 
    refill_threshold: Decimal
) -> Bucket

Parameters

receipt_bucket - Single Liquidity Receipt NFT

refill_threshold - New threshold in XRD

Minimum: 10,000 XRD (configurable by admin)
Must be less than total position value

Returns

Bucket - The same Receipt NFT

update_refill_threshold Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw_non_fungibles"
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#")
    )
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "update_refill_threshold"
    Bucket("receipt_bucket")
    Decimal("30000")
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

update_automation_fee

Updates fee offered to automation processors.

Signature

pub fn update_automation_fee(
    &mut self, 
    receipt_bucket: Bucket, 
    automation_fee: Decimal
) -> Bucket

Parameters

receipt_bucket - Single Liquidity Receipt NFT

automation_fee - New fee in XRD

Can be any positive amount
Higher fees incentivize faster processing

Returns

Bucket - The same Receipt NFT

update_automation_fee Manifest

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "withdraw_non_fungibles"
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Array<NonFungibleLocalId>(
        NonFungibleLocalId("#123#")
    )
;
TAKE_ALL_FROM_WORKTOP
    Address("resource_tdx_2_1n2nsqg5eaeq8xqhz38kxq5tznvsglddzlqdxcfj7tc6u8t02uan99n")
    Bucket("receipt_bucket")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "update_automation_fee"
    Bucket("receipt_bucket")
    Decimal("10")
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

Getter Methods

get_claimable_xrd

Queries claimable XRD for a liquidity position.

Signature

pub fn get_claimable_xrd(
    &self, 
    receipt_id: NonFungibleLocalId
) -> (Decimal, u64, Decimal, Decimal)

Parameters

receipt_id - NFT ID with hashes (e.g., "#123#")

Returns

(Decimal, u64, Decimal, Decimal) - Tuple containing:

claimable_now - XRD claimable immediately
total_fills - Number of fills to collect
stake_value - Total value in stake claims
lsu_value - Total LSU redemption value

get_claimable_xrd Manifest

CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "get_claimable_xrd"
    NonFungibleLocalId("#123#")
;

get_receipt_detail

Gets complete position information.

Signature

pub fn get_receipt_detail(
    &self, 
    receipt_id: NonFungibleLocalId
) -> ReceiptDetailData

Parameters

receipt_id - NFT ID with hashes (e.g., "#123#")

Returns

ReceiptDetailData - Complete position information:

struct ReceiptDetailData {
    receipt_id: NonFungibleLocalId,     // The NFT ID
    discount: Decimal,                  // Discount rate (0.01 = 1%)
    auto_unstake: bool,                 // Auto-unstake enabled
    auto_refill: bool,                  // Auto-refill enabled
    refill_threshold: Decimal,          // Refill trigger amount
    xrd_liquidity_available: Decimal,   // Available for orders
    xrd_liquidity_filled: Decimal,      // Historical volume
    liquidity_ahead: Decimal,           // XRD ahead in queue
    fills_to_collect: u64,              // Pending collections
    last_added_epoch: u32,              // Last modification
    claimable_xrd: Decimal,             // Claimable now
    total_stake_claim_value: Decimal,   // Total in stake claims
    total_lsu_redemption_value: Decimal,// Total LSU value
    automation_fee: Decimal             // Fee offered
}

get_receipt_detail Maniest

CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "get_receipt_detail"
    NonFungibleLocalId("#123#")
;

get_raw_buy_list_range

Returns raw order book data for indexing.

Signature

pub fn get_raw_buy_list_range(
    &self, 
    start_index: u64, 
    count: u64
) -> Vec<(u128, NonFungibleGlobalId)>

Parameters

start_index - Starting position in order book

0-based indexing
Use for pagination

count - Number of entries to return

Maximum limited by gas

Returns

Vec<(u128, NonFungibleGlobalId)> - Pairs of:

AVL tree key (encodes discount, auto_unstake, position, ID)
Receipt global ID

Key Structure

[16 bits: discount][16 bits: auto_unstake][64 bits: position][32 bits: receipt_id]

get_raw_buy_list_range Manifest

CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "get_raw_buy_list_range"
    0u64
    100u64
;

get_active_liquidity_positions

Returns detailed info for active positions.

Signature

pub fn get_active_liquidity_positions(
    &self, 
    start_index: u64, 
    count: u64
) -> Vec<ReceiptDetailData>

Parameters

start_index - Starting position

0-based indexing

count - Number to return

Limited by gas

Returns

Vec<ReceiptDetailData> - Full details for each active position in order book

get_active_liquidity_positions Manifest

CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "get_active_liquidity_positions"
    0u64
    50u64
;

get_automation_ready_receipts

Finds positions ready for automated processing.

Signature

pub fn get_automation_ready_receipts(
    &self, 
    start_index: u64, 
    batch_size: u64
) -> Vec<AutomationReadyReceipt>

Parameters

start_index - Starting position in automation queue

1-based indexing
Use for pagination

batch_size - Number to return

Recommended: 10-20
Maximum: 100
Larger batches = more gas

Returns

Vec<AutomationReadyReceipt> - Ready positions with:

struct AutomationReadyReceipt {
    receipt_id: NonFungibleLocalId,
    discount: Decimal,
    fills_to_collect: u64,
    claimable_xrd: Decimal,
    refill_threshold: Decimal,
    automation_fee: Decimal
}

Eligibility Criteria

Has auto_refill enabled
Claimable XRD ≥ refill threshold
Has matured stake claims

get_automation_ready_receipts Manifest

CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "get_automation_ready_receipts"
    1u64
    20u64
;

Admin Methods

set_component_status

Enables or disables new liquidity deposits.

Signature

pub fn set_component_status(&mut self, status: bool)

Authorization Required: Owner badge

Parameters

status - Component status

false: Prevents new add_liquidity calls
true: Normal operation

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "set_component_status"
    true
;

set_platform_fee

Sets the fee charged on unstaking operations.

Signature

pub fn set_platform_fee(&mut self, fee: Decimal)

Authorization Required: Owner badge

Parameters

fee - Fee as decimal

Example: 0.0005 = 0.05%
Reasonable range: 0.01% - 0.5%

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "set_platform_fee"
    Decimal("0.0005")
;

set_minimum_liquidity

Sets minimum XRD required for liquidity positions.

Signature

pub fn set_minimum_liquidity(&mut self, min: Decimal)

Authorization Required: Owner badge

Parameters

min - Minimum XRD amount

Default: 10,000 XRD
Trade-off: Higher = more efficient, less accessible

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "set_minimum_liquidity"
    Decimal("10000")
;

set_unstake_value_range

Sets min/max values for unstaking operations.

Signature

pub fn set_unstake_value_range(
    &mut self, 
    min: Decimal, 
    max: Decimal
)

Authorization Required: Owner badge

Parameters

min - Minimum unstake value in XRD

Default: 0 XRD

max - Maximum unstake value in XRD

Default: 10,000,000 XRD

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "set_unstake_value_range"
    Decimal("0")
    Decimal("10000000")
;

set_small_order_threshold

Sets threshold for small order routing.

Signature

pub fn set_small_order_threshold(&mut self, threshold: Decimal)

Authorization Required: Owner badge

Parameters

threshold - XRD value threshold

Default: 1,000 XRD
Orders below only match manual positions

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "set_small_order_threshold"
    Decimal("1000")
;

set_max_fills_per_cycle

Sets maximum fills processed per automation cycle.

Signature

pub fn set_max_fills_per_cycle(&mut self, max_fills: u64)

Authorization Required: Owner badge

Parameters

max_fills - Maximum fills per cycle

Default: 50
Trade-off: Higher = more gas, fewer transactions

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "set_max_fills_per_cycle"
    50u64
;

collect_platform_fees

Withdraws accumulated platform fees.

Signature

pub fn collect_platform_fees(&mut self) -> Bucket

Authorization Required: Owner badge

Returns

Bucket - All accumulated platform fees in XRD

CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "create_proof_of_amount"
    Address("resource_tdx_2_1tkckx9fynl0f3jfpntqxnzl6qc4w3jq96tqfslvdedwhaeseajtw9g")
    Decimal("1")
;
CALL_METHOD
    Address("component_tdx_2_1cz5zn7d5yl5usqvgmxcqpgztzhayes7nyt8vqy2y3huqujwclpxjfw")
    "collect_platform_fees"
;
CALL_METHOD
    Address("account_tdx_2_1298qr4yymzfvjfqn48f5k00r79snw695zln0lxele0c2jgrwsdhwkc")
    "deposit_batch"
    Expression("ENTIRE_WORKTOP")
;

PreviousComponent Info NextPlatform Parameters

Last updated 1 month ago