Pythia

Pythia is a canister that provides the SubPub functionality for the Ethereum family smart contracts.

Deploy local

make all SYBIL_CANISTER={SYBIL CANISTER ID}

Upgrade local

make upgrade_local

Upgrade production/staging

dfx build pythia --network ic && gzip -f -1 ./.dfx/ic/canisters/pythia/pythia.wasm
dfx canister install --wasm ./.dfx/ic/canisters/pythia/pythia.wasm.gz --argument "(30000000:nat, \"key_1\", principal \"vk6h6-zyaaa-aaaak-qceta-cai\", principal \"tysiw-qaaaa-aaaak-qcikq-cai\")" --network ic pythia
dfx canister install --wasm ./.dfx/ic/canisters/pythia/pythia.wasm.gz --network ic pythia -m upgrade

Enviroment

CHAIN_ID=5 &&
UPDATE_TIME_FREQUENCY=300 &&
RPC="https://ethereum-goerli.publicnode.com" &&
MIN_BALANCE=1000000000 &&
BLOCK_GAS_LIMIT=300000000 &&
PLATFORM_FEE=1 &&
CHAIN_SYMBOL="ETH" &&
ADDRESS="0x6696eD42dFBe875E60779b8163fDCc39B088222A" &&
SIWE_MSG="localhost:4361 wants you to sign in with your Ethereum account:
0x6696eD42dFBe875E60779b8163fDCc39B088222A

Sign in with Ethereum.

URI: http://localhost:4361
Version: 1
Chain ID: 324
Nonce: NUY87tYWuZwkxrTZM
Issued At: 2023-11-03T11:40:39.690Z" &&
SIWE_SIG="31f8f8ea2104062e242dc13b9729c75b866e1ab1635c69404a1e7438221ff23849ea6a82e2544d28b4a16075f27fd3db6569e8664191af501572ad342e616c0300" &&
CONTRACT_ADDR="0xECD94bc01120A01D5121C8934859faA402849Ca1" && 
METHOD_ABI="increment_counter()" && 
SET_PRICE_FEED_ID="custom_BTC/USDT" &&
SET_PRICE_METHOD_ABI="set_price(string, uint256, uint256, uint256)" &&
SET_CUSTOM_NUMBER_FEED_ID="custom_get_logs_investly_subscription" &&
SET_CUSTOM_NUMBER_METHOD_ABI="set_custom_number(string, uint256, uint256)" &&
SET_CUSTOM_STRING_FEED_ID="custom_get_logs_example" &&
SET_CUSTOM_STRING_METHOD_ABI="set_custom_string(string, string)" &&
GAS_LIMIT=1000000 && 
MUTATION_RATE=1 && 
CONDITION_PRICE_ID="ETH/USD" && 
MUTATION_TYPE="Both" 
MULTICALL_CONTRACT="{Enter your evm-oracle multicall smartcontract}" && 
TX_HASH="{Enter tx where you sent some tokens to the sybil address}"
SUBSCRIPTION_ID={Enter subscription id}

Usage

# update the timer frequency for debug
dfx canister call pythia update_timer_frequency "(${UPDATE_TIME_FREQUENCY}:nat)"
# add a new supported chain
dfx canister call pythia add_chain "(record {chain_id=${CHAIN_ID}:nat; rpc=\"${RPC}\"; min_balance=${MIN_BALANCE}:nat; block_gas_limit=${BLOCK_GAS_LIMIT}:nat; fee=${PLATFORM_FEE}:nat; symbol=\"${CHAIN_SYMBOL}\"; multicall_contract=\"${MULTICALL_CONTRACT}\"})"
# update chain rpc
dfx canister call pythia update_chain_rpc "(${CHAIN_ID}:nat, \"${RPC}\")"
# to update nulticall contract 
dfx canister call pythia update_chain_multicall_contract "(${CHAIN_ID}:nat, \"${MULTICALL_CONTRACT}\")"
# add to whitelist
dfx canister call pythia add_to_whitelist "(\"${ADDRESS}\")"
# get the PMA
dfx canister call pythia get_pma
# deposit a funds to the pma
dfx canister call pythia deposit "(${CHAIN_ID}:nat, \"${TX_HASH}\", \"${SIWE_MSG}\", \"${SIWE_SIG}\")"
# get balace 
dfx canister call pythia get_balance "(${CHAIN_ID}:nat, \"${ADDRESS}\")"
# get balance 
dfx canister call pythia get_balance "(${CHAIN_ID}, \"${ADDRESS}\")"
# withdraw balance 
dfx canister call pythia withdraw "(${CHAIN_ID}, \"${SIWE_MSG}\", \"${SIWE_SIG}\", \"${ADDRESS}\")"


# create a feed subscription with a frequency condition
dfx canister call pythia subscribe "(record {chain_id=${CHAIN_ID}:nat; feed_id=opt \"${SET_PRICE_FEED_ID}\"; label=\"test\"; contract_addr=\"${CONTRACT_ADDR}\"; method_abi=\"${SET_PRICE_METHOD_ABI}\"; is_random=false; gas_limit=${GAS_LIMIT}:nat; frequency_condition=opt ${UPDATE_TIME_FREQUENCY}; price_mutation_condition=null; msg=\"${SIWE_MSG}\"; sig=\"${SIWE_SIG}\"})"

# create a custom number feed subscription with a frequency condition
dfx canister call pythia subscribe "(record {chain_id=${CHAIN_ID}:nat; feed_id=opt \"${SET_CUSTOM_NUMBER_FEED_ID}\"; label=\"test\"; contract_addr=\"${CONTRACT_ADDR}\"; method_abi=\"${SET_CUSTOM_NUMBER_METHOD_ABI}\"; is_random=false; gas_limit=${GAS_LIMIT}:nat; frequency_condition=opt ${UPDATE_TIME_FREQUENCY}; price_mutation_condition=null; msg=\"${SIWE_MSG}\"; sig=\"${SIWE_SIG}\"})"

# create a custom string feed subscription with a frequency condition
dfx canister call pythia subscribe "(record {chain_id=${CHAIN_ID}:nat; feed_id=opt \"${SET_CUSTOM_STRING_FEED_ID}\"; label=\"test\"; contract_addr=\"${CONTRACT_ADDR}\"; method_abi=\"${SET_CUSTOM_STRING_METHOD_ABI}\"; is_random=false; gas_limit=${GAS_LIMIT}:nat; frequency_condition=opt ${UPDATE_TIME_FREQUENCY}; price_mutation_condition=null; msg=\"${SIWE_MSG}\"; sig=\"${SIWE_SIG}\"})"


# create a subscription with a frequency condition
dfx canister call pythia subscribe "(record {chain_id=${CHAIN_ID}:nat; feed_id=null; label=\"test\"; contract_addr=\"${CONTRACT_ADDR}\"; method_abi=\"${METHOD_ABI}\"; is_random=false; gas_limit=${GAS_LIMIT}:nat; frequency_condition=opt ${UPDATE_TIME_FREQUENCY}; price_mutation_condition=null; msg=\"${SIWE_MSG}\"; sig=\"${SIWE_SIG}\"})"

# create a subscription with a price mutation condition
dfx canister call pythia subscribe "(record {chain_id=${CHAIN_ID}:nat; feed_id=null; label=\"test\"; contract_addr=\"${CONTRACT_ADDR}\"; method_abi=\"${METHOD_ABI}\"; is_random=false; gas_limit=${GAS_LIMIT}:nat; frequency_condition=null; price_mutation_condition=opt record {mutation_rate=${MUTATION_RATE}; feed_id=\"${CONDITION_PRICE_ID}\"; price_mutation_type=variant {${MUTATION_TYPE}}}; msg=\"${SIWE_MSG}\"; sig=\"${SIWE_SIG}\"})"


# to remove subscriptions
dfx canister call pythia remove_subscription "(${SUBSCRIPTION_ID})"
# to get all user subscriptions 
dfx canister call pythia get_subscriptions "(opt \"${ADDRESS}\")"
# to update subscription 
dfx canister call pythia update_subscription  "(record {chain_id=${CHAIN_ID}:nat; feed_id=null; id=${SUBSCRIPTION_ID}:nat; contract_addr=opt \"${CONTRACT_ADDR}\"; method_abi=opt \"${METHOD_ABI}\"; is_random=opt false; gas_limit=opt ${GAS_LIMIT}; frequency_condition=opt ${UPDATE_TIME_FREQUENCY}; price_mutation_condition=null; msg=\"${SIWE_MSG}\"; sig=\"${SIWE_SIG}\"})"
# stop subscription
dfx canister call pythia stop_subscription "(${CHAIN_ID}, ${SUBSCRIPTION_ID}, \"${SIWE_MSG}\", \"${SIWE_SIG}\")"
# start subscription
dfx canister call pythia start_subscription "(${CHAIN_ID}, ${SUBSCRIPTION_ID}, \"${SIWE_MSG}\", \"${SIWE_SIG}\")"