Source Code


;; xyk-swap-helper-v-1-2

;; Use XYK ft trait and XYK pool trait
(use-trait xyk-ft-trait .sip-010-trait-ft-standard-v-1-1.sip-010-trait)
(use-trait xyk-pool-trait .xyk-pool-trait-v-1-2.xyk-pool-trait)

;; Error constants
(define-constant ERR_NOT_AUTHORIZED (err u6001))
(define-constant ERR_INVALID_AMOUNT (err u6002))
(define-constant ERR_INVALID_PRINCIPAL (err u6003))
(define-constant ERR_ALREADY_ADMIN (err u6004))
(define-constant ERR_ADMIN_LIMIT_REACHED (err u6005))
(define-constant ERR_ADMIN_NOT_IN_LIST (err u6006))
(define-constant ERR_CANNOT_REMOVE_CONTRACT_DEPLOYER (err u6007))
(define-constant ERR_SWAP_STATUS (err u6008))
(define-constant ERR_MINIMUM_RECEIVED (err u6009))

;; Contract deployer address
(define-constant CONTRACT_DEPLOYER tx-sender)

;; Admins list and helper var used to remove admins
(define-data-var admins (list 5 principal) (list tx-sender))
(define-data-var admin-helper principal tx-sender)

;; Data var used to enable or disable quotes and swaps
(define-data-var swap-status bool true)

;; Get admins list
(define-read-only (get-admins)
    (ok (var-get admins))
)

;; Get admin helper var
(define-read-only (get-admin-helper)
    (ok (var-get admin-helper))
)

;; Get swap status
(define-read-only (get-swap-status)
    (ok (var-get swap-status))
)

;; Add an admin to the admins list
(define-public (add-admin (admin principal))
    (let (
    (admins-list (var-get admins))
    (caller tx-sender)
    )
    ;; Assert caller is an existing admin and new admin is not in admins-list
    (asserts! (is-some (index-of admins-list caller)) ERR_NOT_AUTHORIZED)
    (asserts! (is-none (index-of admins-list admin)) ERR_ALREADY_ADMIN)

    ;; Add admin to list with max length of 5
    (var-set admins (unwrap! (as-max-len? (append admins-list admin) u5) ERR_ADMIN_LIMIT_REACHED))

    ;; Print add admin data and return true
    (print {action: "add-admin", caller: caller, data: {admin: admin}})
    (ok true)
    )
)

;; Remove an admin from the admins list
(define-public (remove-admin (admin principal))
    (let (
    (admins-list (var-get admins))
    (caller tx-sender)
    )
    ;; Assert caller is an existing admin and admin to remove is in admins-list
    (asserts! (is-some (index-of admins-list caller)) ERR_NOT_AUTHORIZED)
    (asserts! (is-some (index-of admins-list admin)) ERR_ADMIN_NOT_IN_LIST)

    ;; Assert contract deployer cannot be removed
    (asserts! (not (is-eq admin CONTRACT_DEPLOYER)) ERR_CANNOT_REMOVE_CONTRACT_DEPLOYER)

    ;; Set admin-helper to admin to remove and filter admins-list to remove admin
    (var-set admin-helper admin)
    (var-set admins (filter admin-not-removable admins-list))

    ;; Print remove admin data and return true
    (print {action: "remove-admin", caller: caller, data: {admin: admin}})
    (ok true)
    )
)

;; Enable or disable quotes and swaps
(define-public (set-swap-status (status bool))
    (let (
    (caller tx-sender)
    )
    (begin
        ;; Assert caller is an admin
        (asserts! (is-some (index-of (var-get admins) caller)) ERR_NOT_AUTHORIZED)

        ;; Set swap-status to status
        (var-set swap-status status)

        ;; Print function data and return true
        (print {action: "set-swap-status", caller: caller, data: {status: status}})
        (ok true)
    )
    )
)

;; Get quote for swap-helper-a
(define-public (get-quote-a
    (amount uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Get quotes for each swap
    (quote-a (try! (xyk-qa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    )
    ;; Return number of b tokens the caller would receive
    (ok quote-a)
    )
)

;; Get quote for swap-helper-b
(define-public (get-quote-b
    (amount uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Get quotes for each swap
    (quote-a (try! (xyk-qa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (quote-b (try! (xyk-qa quote-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    )
    ;; Return number of d tokens the caller would receive
    (ok quote-b)
    )
)

;; Get quote for swap-helper-c
(define-public (get-quote-c
    (amount uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>) (e <xyk-ft-trait>) (f <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>) (c <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Get quotes for each swap
    (quote-a (try! (xyk-qa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (quote-b (try! (xyk-qa quote-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    (quote-c (try! (xyk-qa quote-b (get e xyk-tokens) (get f xyk-tokens) (get c xyk-pools))))
    )
    ;; Return number of f tokens the caller would receive
    (ok quote-c)
    )
)

;; Get quote for swap-helper-d
(define-public (get-quote-d
    (amount uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>) (e <xyk-ft-trait>) (f <xyk-ft-trait>) (g <xyk-ft-trait>) (h <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>) (c <xyk-pool-trait>) (d <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Get quotes for each swap
    (quote-a (try! (xyk-qa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (quote-b (try! (xyk-qa quote-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    (quote-c (try! (xyk-qa quote-b (get e xyk-tokens) (get f xyk-tokens) (get c xyk-pools))))
    (quote-d (try! (xyk-qa quote-c (get g xyk-tokens) (get h xyk-tokens) (get d xyk-pools))))
    )
    ;; Return number of h tokens the caller would receive
    (ok quote-d)
    )
)

;; Get quote for swap-helper-e
(define-public (get-quote-e
    (amount uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>) (e <xyk-ft-trait>) (f <xyk-ft-trait>) (g <xyk-ft-trait>) (h <xyk-ft-trait>) (i <xyk-ft-trait>) (j <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>) (c <xyk-pool-trait>) (d <xyk-pool-trait>) (e <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Get quotes for each swap
    (quote-a (try! (xyk-qa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (quote-b (try! (xyk-qa quote-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    (quote-c (try! (xyk-qa quote-b (get e xyk-tokens) (get f xyk-tokens) (get c xyk-pools))))
    (quote-d (try! (xyk-qa quote-c (get g xyk-tokens) (get h xyk-tokens) (get d xyk-pools))))
    (quote-e (try! (xyk-qa quote-d (get i xyk-tokens) (get j xyk-tokens) (get e xyk-pools))))
    )
    ;; Return number of j tokens the caller would receive
    (ok quote-e)
    )
)

;; Swap via 1 XYK pool
(define-public (swap-helper-a
    (amount uint) (min-received uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Perform each swap
    (swap-a (try! (xyk-sa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    )
    (begin
        ;; Assert that swap-a is greater than or equal to min-received
        (asserts! (>= swap-a min-received) ERR_MINIMUM_RECEIVED)

        ;; Print swap data and return number of b tokens the caller received
        (print {
        action: "swap-helper-a",
        caller: tx-sender, 
        data: {
            amount: amount,
            min-received: min-received,
            received: swap-a,
            xyk-data: {
            xyk-tokens: xyk-tokens,
            xyk-pools: xyk-pools,
            xyk-swaps: {
                a: swap-a
            }
            }
        }
        })
        (ok swap-a)
    )
    )
)

;; Swap via 2 XYK pools
(define-public (swap-helper-b
    (amount uint) (min-received uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Perform each swap
    (swap-a (try! (xyk-sa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (swap-b (try! (xyk-sa swap-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    )
    (begin
        ;; Assert that swap-b is greater than or equal to min-received
        (asserts! (>= swap-b min-received) ERR_MINIMUM_RECEIVED)

        ;; Print swap data and return number of d tokens the caller received
        (print {
        action: "swap-helper-b",
        caller: tx-sender, 
        data: {
            amount: amount,
            min-received: min-received,
            received: swap-b,
            xyk-data: {
            xyk-tokens: xyk-tokens,
            xyk-pools: xyk-pools,
            xyk-swaps: {
                a: swap-a,
                b: swap-b
            }
            }
        }
        })
        (ok swap-b)
    )
    )
)

;; Swap via 3 XYK pools
(define-public (swap-helper-c
    (amount uint) (min-received uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>) (e <xyk-ft-trait>) (f <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>) (c <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Perform each swap
    (swap-a (try! (xyk-sa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (swap-b (try! (xyk-sa swap-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    (swap-c (try! (xyk-sa swap-b (get e xyk-tokens) (get f xyk-tokens) (get c xyk-pools))))
    )
    (begin
        ;; Assert that swap-c is greater than or equal to min-received
        (asserts! (>= swap-c min-received) ERR_MINIMUM_RECEIVED)

        ;; Print swap data and return number of f tokens the caller received
        (print {
        action: "swap-helper-c",
        caller: tx-sender, 
        data: {
            amount: amount,
            min-received: min-received,
            received: swap-c,
            xyk-data: {
            xyk-tokens: xyk-tokens,
            xyk-pools: xyk-pools,
            xyk-swaps: {
                a: swap-a,
                b: swap-b,
                c: swap-c
            }
            }
        }
        })
        (ok swap-c)
    )
    )
)

;; Swap via 4 XYK pools
(define-public (swap-helper-d
    (amount uint) (min-received uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>) (e <xyk-ft-trait>) (f <xyk-ft-trait>) (g <xyk-ft-trait>) (h <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>) (c <xyk-pool-trait>) (d <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Perform each swap
    (swap-a (try! (xyk-sa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (swap-b (try! (xyk-sa swap-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    (swap-c (try! (xyk-sa swap-b (get e xyk-tokens) (get f xyk-tokens) (get c xyk-pools))))
    (swap-d (try! (xyk-sa swap-c (get g xyk-tokens) (get h xyk-tokens) (get d xyk-pools))))
    )
    (begin
        ;; Assert that swap-d is greater than or equal to min-received
        (asserts! (>= swap-d min-received) ERR_MINIMUM_RECEIVED)

        ;; Print swap data and return number of h tokens the caller received
        (print {
        action: "swap-helper-d",
        caller: tx-sender, 
        data: {
            amount: amount,
            min-received: min-received,
            received: swap-d,
            xyk-data: {
            xyk-tokens: xyk-tokens,
            xyk-pools: xyk-pools,
            xyk-swaps: {
                a: swap-a,
                b: swap-b,
                c: swap-c,
                d: swap-d
            }
            }
        }
        })
        (ok swap-d)
    )
    )
)

;; Swap via 5 XYK pools
(define-public (swap-helper-e
    (amount uint) (min-received uint)
    (xyk-tokens (tuple (a <xyk-ft-trait>) (b <xyk-ft-trait>) (c <xyk-ft-trait>) (d <xyk-ft-trait>) (e <xyk-ft-trait>) (f <xyk-ft-trait>) (g <xyk-ft-trait>) (h <xyk-ft-trait>) (i <xyk-ft-trait>) (j <xyk-ft-trait>)))
    (xyk-pools (tuple (a <xyk-pool-trait>) (b <xyk-pool-trait>) (c <xyk-pool-trait>) (d <xyk-pool-trait>) (e <xyk-pool-trait>)))
    )
    (let (
    ;; Assert that swap-status is true and amount is greater than 0
    (swap-status-check (asserts! (is-eq (var-get swap-status) true) ERR_SWAP_STATUS))
    (amount-check (asserts! (> amount u0) ERR_INVALID_AMOUNT))

    ;; Perform each swap
    (swap-a (try! (xyk-sa amount (get a xyk-tokens) (get b xyk-tokens) (get a xyk-pools))))
    (swap-b (try! (xyk-sa swap-a (get c xyk-tokens) (get d xyk-tokens) (get b xyk-pools))))
    (swap-c (try! (xyk-sa swap-b (get e xyk-tokens) (get f xyk-tokens) (get c xyk-pools))))
    (swap-d (try! (xyk-sa swap-c (get g xyk-tokens) (get h xyk-tokens) (get d xyk-pools))))
    (swap-e (try! (xyk-sa swap-d (get i xyk-tokens) (get j xyk-tokens) (get e xyk-pools))))
    )
    (begin
        ;; Assert that swap-e is greater than or equal to min-received
        (asserts! (>= swap-e min-received) ERR_MINIMUM_RECEIVED)

        ;; Print swap data and return number of j tokens the caller received
        (print {
        action: "swap-helper-e",
        caller: tx-sender, 
        data: {
            amount: amount,
            min-received: min-received,
            received: swap-e,
            xyk-data: {
            xyk-tokens: xyk-tokens,
            xyk-pools: xyk-pools,
            xyk-swaps: {
                a: swap-a,
                b: swap-b,
                c: swap-c,
                d: swap-d,
                e: swap-e
            }
            }
        }
        })
        (ok swap-e)
    )
    )
)

;; Helper function for removing an admin
(define-private (admin-not-removable (admin principal))
    (not (is-eq admin (var-get admin-helper)))
)

;; Check if input and output tokens are swapped relative to the pool's x and y tokens
(define-private (is-xyk-path-reversed
    (token-in <xyk-ft-trait>) (token-out <xyk-ft-trait>)
    (pool-contract <xyk-pool-trait>)
    )
    (let (
    (pool-data (unwrap-panic (contract-call? pool-contract get-pool)))
    )
    (not 
        (and 
        (is-eq (contract-of token-in) (get x-token pool-data))
        (is-eq (contract-of token-out) (get y-token pool-data))
        )
    )
    )
)

;; Get XYK quote using get-dy or get-dx based on token path
(define-private (xyk-qa
    (amount uint)
    (token-in <xyk-ft-trait>) (token-out <xyk-ft-trait>)
    (pool <xyk-pool-trait>)
    )
    (let (
    ;; Determine if the token path is reversed
    (is-reversed (is-xyk-path-reversed token-in token-out pool))
    
    ;; Get quote based on path
    (quote-a (if (is-eq is-reversed false)
                    (try! (contract-call?
                    .xyk-core-v-1-2 get-dy
                    pool
                    token-in token-out
                    amount))
                    (try! (contract-call?
                    .xyk-core-v-1-2 get-dx
                    pool
                    token-out token-in
                    amount))))
    )
    (ok quote-a)
    )
)

;; Perform XYK swap using swap-x-for-y or swap-y-for-x based on token path
(define-private (xyk-sa
    (amount uint)
    (token-in <xyk-ft-trait>) (token-out <xyk-ft-trait>)
    (pool <xyk-pool-trait>)
    )
    (let (
    ;; Determine if the token path is reversed
    (is-reversed (is-xyk-path-reversed token-in token-out pool))
    
    ;; Perform swap based on path
    (swap-a (if (is-eq is-reversed false)
                (try! (contract-call?
                        .xyk-core-v-1-2 swap-x-for-y
                        pool
                        token-in token-out
                        amount u1))
                (try! (contract-call?
                        .xyk-core-v-1-2 swap-y-for-x
                        pool
                        token-out token-in
                        amount u1))))
    )
    (ok swap-a)
    )
)

Functions (17)

FunctionAccessArgs
get-adminsread-only
get-admin-helperread-only
get-swap-statusread-only
add-adminpublicadmin: principal
remove-adminpublicadmin: principal
set-swap-statuspublicstatus: bool
get-quote-apublicamount: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>
get-quote-bpublicamount: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>
get-quote-cpublicamount: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>, e: <xyk-ft-trait>, f: <xyk-ft-trait>
get-quote-dpublicamount: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>, e: <xyk-ft-trait>, f: <xyk-ft-trait>, g: <xyk-ft-trait>, h: <xyk-ft-trait>
get-quote-epublicamount: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>, e: <xyk-ft-trait>, f: <xyk-ft-trait>, g: <xyk-ft-trait>, h: <xyk-ft-trait>, i: <xyk-ft-trait>, j: <xyk-ft-trait>
swap-helper-apublicamount: uint, min-received: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>
swap-helper-bpublicamount: uint, min-received: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>
swap-helper-cpublicamount: uint, min-received: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>, e: <xyk-ft-trait>, f: <xyk-ft-trait>
swap-helper-dpublicamount: uint, min-received: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>, e: <xyk-ft-trait>, f: <xyk-ft-trait>, g: <xyk-ft-trait>, h: <xyk-ft-trait>
swap-helper-epublicamount: uint, min-received: uint, xyk-tokens: (tuple (a <xyk-ft-trait>, b: <xyk-ft-trait>, c: <xyk-ft-trait>, d: <xyk-ft-trait>, e: <xyk-ft-trait>, f: <xyk-ft-trait>, g: <xyk-ft-trait>, h: <xyk-ft-trait>, i: <xyk-ft-trait>, j: <xyk-ft-trait>
admin-not-removableprivateadmin: principal