Source Code

;; Index Contract - Combined LP Token and AMM implementation

;; Implement SIP-010 trait
(impl-trait .charisma-traits-v1.sip010-ft-trait)
(use-trait rulebook-trait .charisma-traits-v1.rulebook-trait)

;; Define the LP token
(define-fungible-token index)

;; Constants
(define-constant DEPLOYER tx-sender)
(define-constant CONTRACT (as-contract tx-sender))
(define-constant ERR_UNAUTHORIZED (err u401))
(define-constant MAX_SWAP_FEE u50000) ;; 5%
(define-constant FEE_DENOMINATION u1000000)
(define-constant ERR_INVALID_FEE (err u402))
(define-constant PRECISION u1000000)
(define-constant MAX_ALPHA u1000000) ;; 1.0 in fixed point
(define-constant MIN_ALPHA u0)       ;; 0.0 = constant sum (stableswap)
                                     ;; 1.0 = constant product

;; Storage
(define-data-var owner principal DEPLOYER)
(define-data-var alpha uint u1000000) ;; Default to constant product
(define-data-var token-name (string-ascii 32) "HooterDex")
(define-data-var token-symbol (string-ascii 10) "HDX")
(define-data-var token-uri (optional (string-utf8 256)) 
  (some u"https://charisma.rocks/sip10/hooter/metadata.json"))
(define-data-var contract-uri (optional (string-utf8 256)) 
  (some u"https://charisma.rocks/api/v0/interactions/engines/hooterdex"))
(define-data-var swap-fee uint u4000) ;; Default 0.4%
(define-data-var first-start-block uint stacks-block-height)

(define-map last-tap-block principal uint)

;; Protocol fee
(define-private (tap-and-pay (rulebook <rulebook-trait>))
  (begin
    (asserts! (match (contract-call? .charisma-rulebook-registry authorize rulebook)
      success true error false) ERR_UNAUTHORIZED)
    (match (tap rulebook) success true error false)
    (contract-call? rulebook pay-to-play)))

;; Configuration functions

(define-public (set-owner (new-owner principal))
  (begin
    (asserts! (is-eq contract-caller (var-get owner)) ERR_UNAUTHORIZED)
    (ok (var-set owner new-owner))))

(define-public (set-alpha (new-alpha uint))
  (begin
    (asserts! (is-eq contract-caller (var-get owner)) ERR_UNAUTHORIZED)
    (asserts! (<= new-alpha MAX_ALPHA) ERR_UNAUTHORIZED)
    (ok (var-set alpha new-alpha))))

(define-public (set-swap-fee (new-fee uint))
  (begin
    (asserts! (is-eq contract-caller (var-get owner)) ERR_UNAUTHORIZED)
    (asserts! (<= new-fee MAX_SWAP_FEE) ERR_UNAUTHORIZED)
    (ok (var-set swap-fee new-fee))))

(define-public (set-token-uri (value (string-utf8 256)))
  (if (is-eq contract-caller (var-get owner))
    (ok (var-set token-uri (some value))) 
    ERR_UNAUTHORIZED))

(define-public (set-contract-uri (new-uri (optional (string-utf8 256))))
  (begin
    (asserts! (is-eq contract-caller (var-get owner)) ERR_UNAUTHORIZED)
    (ok (var-set contract-uri new-uri))))

;; Core AMM operations

(define-private (calculate-output-amount 
    (x uint)     ;; reserve in
    (y uint)     ;; reserve out
    (dx uint)    ;; amount in
    (amp uint))  ;; alpha parameter
  (let (
    ;; Constant sum portion (better for similar values)
    (sum-term (/ (* dx y) x))
    
    ;; Constant product portion (better for different values)
    (product-term (/ (* dx y) (+ x dx)))
    
    ;; Weighted sum of both terms
    (weighted-output (+ (* (- PRECISION amp) sum-term)
                       (* amp product-term)))
  )
    (/ weighted-output PRECISION)))

(define-public (swap (rulebook <rulebook-trait>) (forward bool) (amt-in uint))
  (let (
    (reserve-in (unwrap-panic (if forward (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT) 
      (contract-call? .hooter-the-owl get-balance CONTRACT))))
    (reserve-out (unwrap-panic (if forward (contract-call? .hooter-the-owl get-balance CONTRACT) 
      (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT))))
    ;; Calculate effective input amount
    (effective-in (/ (* amt-in (- FEE_DENOMINATION (var-get swap-fee))) 
                        FEE_DENOMINATION))
    ;; Calculate output with hybrid curve
    (amt-out (calculate-output-amount 
               reserve-in 
               reserve-out 
               effective-in
               (var-get alpha)))
  )
    (try! (tap-and-pay rulebook))
    (try! (if forward (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token transfer amt-in tx-sender CONTRACT none) 
      (contract-call? .hooter-the-owl transfer amt-in tx-sender CONTRACT none)))
    (try! (as-contract (if forward (contract-call? .hooter-the-owl transfer amt-out CONTRACT tx-sender none)
      (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token transfer amt-out CONTRACT tx-sender none))))
    
    (ok {amt-in: amt-in, amt-out: amt-out})))

(define-public (mint (who principal) (amount uint))
  (let (
    (reserve0 (unwrap-panic (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT)))
    (reserve1 (unwrap-panic (contract-call? .hooter-the-owl get-balance CONTRACT)))
    (total-supply (ft-get-supply index))
    (token0-amount (if (is-eq total-supply u0)
                      amount
                      (/ (* amount reserve0) total-supply)))
    (token1-amount (if (is-eq total-supply u0)
                      amount
                      (/ (* amount reserve1) total-supply)))
  )
    (asserts! (is-eq tx-sender who) ERR_UNAUTHORIZED)
    (try! (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token transfer token0-amount who CONTRACT none))
    (try! (contract-call? .hooter-the-owl transfer token1-amount who CONTRACT none))
    (try! (ft-mint? index amount who))
    
    (ok {token0-amount: token0-amount, 
         token1-amount: token1-amount, 
         lp-amount: amount})))

(define-public (burn (who principal) (amount uint))
  (let (
    (reserve0 (unwrap-panic (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT)))
    (reserve1 (unwrap-panic (contract-call? .hooter-the-owl get-balance CONTRACT)))
    (total-supply (ft-get-supply index))
    (token0-amount (/ (* amount reserve0) total-supply))
    (token1-amount (/ (* amount reserve1) total-supply))
  )
    (asserts! (is-eq tx-sender who) ERR_UNAUTHORIZED)
    (try! (ft-burn? index amount who))
    (try! (as-contract (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token transfer token0-amount CONTRACT who none)))
    (try! (as-contract (contract-call? .hooter-the-owl transfer token1-amount CONTRACT who none)))
    
    (ok {token0-amount: token0-amount, 
         token1-amount: token1-amount, 
         lp-amount: amount})))

;; Read functions

(define-read-only (get-owner)
  (ok (var-get owner)))

(define-read-only (get-alpha)
  (ok (var-get alpha)))

(define-read-only (get-tokens)
  (ok {token0: 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token, token1: .hooter-the-owl}))

(define-read-only (get-swap-fee)
  (ok (var-get swap-fee)))

(define-read-only (get-reserves)
  (ok {
    token0: (unwrap-panic (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT)),
    token1: (unwrap-panic (contract-call? .hooter-the-owl get-balance CONTRACT))
  }))

(define-read-only (get-quote (forward bool) (amt-in uint) (apply-fee bool))
  (let (
    (reserve-in (unwrap-panic (if forward (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT) 
      (contract-call? .hooter-the-owl get-balance CONTRACT))))
    (reserve-out (unwrap-panic (if forward (contract-call? .hooter-the-owl get-balance CONTRACT) 
      (contract-call? 'SP2D5BGGJ956A635JG7CJQ59FTRFRB0893514EZPJ.dme000-governance-token get-balance CONTRACT))))
    ;; Apply fee if requested
    (effective-in (if apply-fee
                     (/ (* amt-in (- FEE_DENOMINATION (var-get swap-fee))) 
                        FEE_DENOMINATION)
                     amt-in))
  )
    (ok (calculate-output-amount 
          reserve-in 
          reserve-out 
          effective-in 
          (var-get alpha)))))

;; SIP-010 Implementation
(define-read-only (get-name)
  (ok (var-get token-name)))

(define-read-only (get-symbol)
  (ok (var-get token-symbol)))

(define-read-only (get-decimals)
  (ok u6))

(define-read-only (get-balance (who principal))
  (ok (ft-get-balance index who)))

(define-read-only (get-total-supply)
  (ok (ft-get-supply index)))

(define-read-only (get-token-uri)
  (ok (var-get token-uri)))

(define-public (transfer (amount uint) (from principal) (to principal) (memo (optional (buff 34))))
  (begin
    (asserts! (is-eq tx-sender from) ERR_UNAUTHORIZED)
    (ft-transfer? index amount from to)))


;; Hold-to-Earn functions

(define-private (get-balance-at (data { address: principal, block: uint }))
    (let ((target-block (get block data)))
        (if (< target-block stacks-block-height)
            (let ((block-hash (unwrap-panic (get-stacks-block-info? id-header-hash target-block))))
                (at-block block-hash (unwrap-panic (get-balance (get address data)))))
                (unwrap-panic (get-balance (get address data))))))

(define-private (calculate-trapezoid-areas-39 (balances (list 39 uint)) (dx uint))
    (list
        (/ (* (+ (unwrap-panic (element-at balances u0)) (unwrap-panic (element-at balances u1))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u1)) (unwrap-panic (element-at balances u2))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u2)) (unwrap-panic (element-at balances u3))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u3)) (unwrap-panic (element-at balances u4))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u4)) (unwrap-panic (element-at balances u5))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u5)) (unwrap-panic (element-at balances u6))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u6)) (unwrap-panic (element-at balances u7))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u7)) (unwrap-panic (element-at balances u8))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u8)) (unwrap-panic (element-at balances u9))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u9)) (unwrap-panic (element-at balances u10))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u10)) (unwrap-panic (element-at balances u11))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u11)) (unwrap-panic (element-at balances u12))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u12)) (unwrap-panic (element-at balances u13))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u13)) (unwrap-panic (element-at balances u14))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u14)) (unwrap-panic (element-at balances u15))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u15)) (unwrap-panic (element-at balances u16))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u16)) (unwrap-panic (element-at balances u17))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u17)) (unwrap-panic (element-at balances u18))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u18)) (unwrap-panic (element-at balances u19))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u19)) (unwrap-panic (element-at balances u20))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u20)) (unwrap-panic (element-at balances u21))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u21)) (unwrap-panic (element-at balances u22))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u22)) (unwrap-panic (element-at balances u23))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u23)) (unwrap-panic (element-at balances u24))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u24)) (unwrap-panic (element-at balances u25))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u25)) (unwrap-panic (element-at balances u26))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u26)) (unwrap-panic (element-at balances u27))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u27)) (unwrap-panic (element-at balances u28))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u28)) (unwrap-panic (element-at balances u29))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u29)) (unwrap-panic (element-at balances u30))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u30)) (unwrap-panic (element-at balances u31))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u31)) (unwrap-panic (element-at balances u32))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u32)) (unwrap-panic (element-at balances u33))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u33)) (unwrap-panic (element-at balances u34))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u34)) (unwrap-panic (element-at balances u35))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u35)) (unwrap-panic (element-at balances u36))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u36)) (unwrap-panic (element-at balances u37))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u37)) (unwrap-panic (element-at balances u38))) dx) u2)))

(define-private (calculate-trapezoid-areas-19 (balances (list 19 uint)) (dx uint))
    (list
        (/ (* (+ (unwrap-panic (element-at balances u0)) (unwrap-panic (element-at balances u1))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u1)) (unwrap-panic (element-at balances u2))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u2)) (unwrap-panic (element-at balances u3))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u3)) (unwrap-panic (element-at balances u4))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u4)) (unwrap-panic (element-at balances u5))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u5)) (unwrap-panic (element-at balances u6))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u6)) (unwrap-panic (element-at balances u7))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u7)) (unwrap-panic (element-at balances u8))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u8)) (unwrap-panic (element-at balances u9))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u9)) (unwrap-panic (element-at balances u10))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u10)) (unwrap-panic (element-at balances u11))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u11)) (unwrap-panic (element-at balances u12))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u12)) (unwrap-panic (element-at balances u13))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u13)) (unwrap-panic (element-at balances u14))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u14)) (unwrap-panic (element-at balances u15))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u15)) (unwrap-panic (element-at balances u16))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u16)) (unwrap-panic (element-at balances u17))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u17)) (unwrap-panic (element-at balances u18))) dx) u2)))

(define-private (calculate-trapezoid-areas-9 (balances (list 9 uint)) (dx uint))
    (list
        (/ (* (+ (unwrap-panic (element-at balances u0)) (unwrap-panic (element-at balances u1))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u1)) (unwrap-panic (element-at balances u2))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u2)) (unwrap-panic (element-at balances u3))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u3)) (unwrap-panic (element-at balances u4))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u4)) (unwrap-panic (element-at balances u5))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u5)) (unwrap-panic (element-at balances u6))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u6)) (unwrap-panic (element-at balances u7))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u7)) (unwrap-panic (element-at balances u8))) dx) u2)))

(define-private (calculate-trapezoid-areas-5 (balances (list 5 uint)) (dx uint))
    (list
        (/ (* (+ (unwrap-panic (element-at balances u0)) (unwrap-panic (element-at balances u1))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u1)) (unwrap-panic (element-at balances u2))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u2)) (unwrap-panic (element-at balances u3))) dx) u2)
        (/ (* (+ (unwrap-panic (element-at balances u3)) (unwrap-panic (element-at balances u4))) dx) u2)))

(define-private (calculate-trapezoid-areas-2 (balances (list 2 uint)) (dx uint))
    (list
        (/ (* (+ (unwrap-panic (element-at balances u0)) (unwrap-panic (element-at balances u1))) dx) u2)))

(define-private (calculate-balance-integral-39 (address principal) (start-block uint) (end-block uint))
    (let (
        (sample-points (contract-call? .meme-engine-manager-rc2 generate-sample-points-39 address start-block end-block))
        (balances (map get-balance-at sample-points))
        (dx (/ (- end-block start-block) u38))
        (areas (calculate-trapezoid-areas-39 balances dx)))
        (fold + areas u0)))

(define-private (calculate-balance-integral-19 (address principal) (start-block uint) (end-block uint))
    (let (
        (sample-points (contract-call? .meme-engine-manager-rc2 generate-sample-points-19 address start-block end-block))
        (balances (map get-balance-at sample-points))
        (dx (/ (- end-block start-block) u18))
        (areas (calculate-trapezoid-areas-19 balances dx)))
        (fold + areas u0)))

(define-private (calculate-balance-integral-9 (address principal) (start-block uint) (end-block uint))
    (let (
        (sample-points (contract-call? .meme-engine-manager-rc2 generate-sample-points-9 address start-block end-block))
        (balances (map get-balance-at sample-points))
        (dx (/ (- end-block start-block) u8))
        (areas (calculate-trapezoid-areas-9 balances dx)))
        (fold + areas u0)))

(define-private (calculate-balance-integral-5 (address principal) (start-block uint) (end-block uint))
    (let (
        (sample-points (contract-call? .meme-engine-manager-rc2 generate-sample-points-5 address start-block end-block))
        (balances (map get-balance-at sample-points))
        (dx (/ (- end-block start-block) u4))
        (areas (calculate-trapezoid-areas-5 balances dx)))
        (fold + areas u0)))

(define-private (calculate-balance-integral-2 (address principal) (start-block uint) (end-block uint))
    (let (
        (sample-points (contract-call? .meme-engine-manager-rc2 generate-sample-points-2 address start-block end-block))
        (balances (map get-balance-at sample-points))
        (dx (/ (- end-block start-block) u1))
        (areas (calculate-trapezoid-areas-2 balances dx)))
        (fold + areas u0)))

(define-private (calculate-balance-integral (address principal) (start-block uint) (end-block uint))
    (let (
        (block-difference (- end-block start-block))
        (thresholds (unwrap-panic (contract-call? .meme-engine-manager-rc2 get-thresholds))))
        (if (>= block-difference (get threshold-39-point thresholds)) (calculate-balance-integral-39 address start-block end-block)
        (if (>= block-difference (get threshold-19-point thresholds)) (calculate-balance-integral-19 address start-block end-block)
        (if (>= block-difference (get threshold-9-point thresholds)) (calculate-balance-integral-9 address start-block end-block)
        (if (>= block-difference (get threshold-5-point thresholds)) (calculate-balance-integral-5 address start-block end-block)
        (calculate-balance-integral-2 address start-block end-block)))))))

(define-read-only (get-last-tap-block (address principal))
    (default-to (var-get first-start-block) (map-get? last-tap-block address)))

(define-read-only (get-contract-uri)
  (ok (var-get contract-uri)))

(define-public (tap (rulebook <rulebook-trait>))
  (let (
    (sender tx-sender)
    (end-block stacks-block-height)
    (start-block (get-last-tap-block sender))
    (balance-integral (calculate-balance-integral sender start-block end-block))
    (incentive-score (contract-call? .aura get-incentive-score CONTRACT))
    (circulating-supply (unwrap-panic (get-total-supply)))
    (potential-energy (/ (* balance-integral incentive-score) circulating-supply)))
    (map-set last-tap-block sender end-block)
    (contract-call? rulebook energize potential-energy sender)))

Functions (37)

FunctionAccessArgs
tap-and-payprivaterulebook: <rulebook-trait>
set-ownerpublicnew-owner: principal
set-alphapublicnew-alpha: uint
set-swap-feepublicnew-fee: uint
set-token-uripublicvalue: (string-utf8 256
set-contract-uripublicnew-uri: (optional (string-utf8 256
swappublicrulebook: <rulebook-trait>, forward: bool, amt-in: uint
mintpublicwho: principal, amount: uint
burnpublicwho: principal, amount: uint
get-ownerread-only
get-alpharead-only
get-tokensread-only
get-swap-feeread-only
get-reservesread-only
get-quoteread-onlyforward: bool, amt-in: uint, apply-fee: bool
get-nameread-only
get-symbolread-only
get-decimalsread-only
get-balanceread-onlywho: principal
get-total-supplyread-only
get-token-uriread-only
transferpublicamount: uint, from: principal, to: principal, memo: (optional (buff 34
get-balance-atprivatedata: { address: principal, block: uint }
calculate-trapezoid-areas-39privatebalances: (list 39 uint
calculate-trapezoid-areas-19privatebalances: (list 19 uint
calculate-trapezoid-areas-9privatebalances: (list 9 uint
calculate-trapezoid-areas-5privatebalances: (list 5 uint
calculate-trapezoid-areas-2privatebalances: (list 2 uint
calculate-balance-integral-39privateaddress: principal, start-block: uint, end-block: uint
calculate-balance-integral-19privateaddress: principal, start-block: uint, end-block: uint
calculate-balance-integral-9privateaddress: principal, start-block: uint, end-block: uint
calculate-balance-integral-5privateaddress: principal, start-block: uint, end-block: uint
calculate-balance-integral-2privateaddress: principal, start-block: uint, end-block: uint
calculate-balance-integralprivateaddress: principal, start-block: uint, end-block: uint
get-last-tap-blockread-onlyaddress: principal
get-contract-uriread-only
tappublicrulebook: <rulebook-trait>