Contextooor

A library to gather more data from your transaction before broadcasting.

pip install contextooor

For local development

1. Fork repo
2. Clone fork git clone https://your-fork-url.com
3. Set up venv

    python3.11 -m venv env
    source env/bin/activate
    cd dir/to/pyproject
    pip install -e .

4. Publishing Bump the version in init.py, then run

    flit build
    flit publish

eth_uniswap:

• Universal router supports execute, but missing support for the second execute method
• Volatility and slippage on all swap methods on V2 router
• Other than multicall, slippage and volatility on all swap methods on V3 router
• TODO: Transactions directly to pairs, multicall on V3, second execute method on universal router, volatility on universal router, fee accounting on universal router

Ethereum:

• Converting to USD
• Concurrent approvals on a specific token
• Concurrent approvals on all tokens
• Total amount approved on a specific token (usd or token value)
• Total amount approved on all tokens (usd)
• Using Forta's attack detector feed labels, is the address a known attacker?
• On the fly audits using slither and slitherin detectors
• Moooore

Bitcoin:

• Decoding to transaction object
• Polars dataframe of recipient and their value (aggregated by recipient)
• Total value of transaction
• Value sent to a specified address
• Recipient is in OFAC Sanction list
• Largest individual amount sent
• Number of recipients
• Arbitrary rich contexting with parquet files

Solana:

• Decoding Base64
• Native Value Transfers (lamports/sol/usd)

How 2 context

EVM Contexting

from contextooor.eth_uniswap import Snippets
from contextooor.eth import Snippets
from web3 import Web3

your_address="0x077B78B2793C956080888c4A496Ea81eCa11827F"
weth_contract="0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
w3=Web3(Web3.HTTPProvider("https://your-rpc-url.com"))

##w3 is an optional variable, defaulting to public rpcs
Snippets(w3=w3).getSlippage(to_address="0x",input_data="0x",value=123)
Snippets(w3=w3).getVolatility(to_address="0x",input_data="0x")

Snippets().get_concurrent_approval_all(your_address=your_address)
Snippets().get_concurrent_approvals_on_token(your_address=your_address,token_address=weth_contract)
Snippets().get_cumulative_approval_amount_on_token(your_address=your_address,token_address=weth_contract,in_usd=True)
Snippets().get_cumulative_approval_amount_usd(your_address=your_address)
Snippets().get_usd_value(token=weth_contract)
Snippets().is_externally_owned_account(address=your_address)
Snippets().get_audit(address=weth_contract)

Bitcoin contexting

from contextooor import btc
encoded_tx="0200000..."
bitcoin=btc.Snippets(encoded_tx)

print("Contains sanctioned addresse(s)?",bitcoin.contains_sanctioned_addresses())

print("total value of transaction in satoshis",bitcoin.total_value())
print("total value of transaction in bitcoin",bitcoin.total_value(denomination="bitcoin"))

print("Largest individual transfer:",bitcoin..max_single_transfer(denomination="bitcoin"))
print("Number of recipients:",bitcoin.recipient_count())

print("Satoshis sent to 'bc1...':",bitcoin.value_to("bc1qdugdmvfqrq5qjlw4ta7alen2hdpsekjkjen5xw"))
print("Bitcoins sent to 'bc1...':",bitcoin.value_to("bc1qdugdmvfqrq5qjlw4ta7alen2hdpsekjkjen5xw",denomination="bitcoin"))

print("Decoded transaction object:",bitcoin.decoded_tx_obj)
print("Polars dataframe of recipient and their value (aggregated to unique addresses)",bitcoin.decoded_dataframe)

print("enriched context:",bitcoin.enrich_context_with_parquet_file("known_scammers.parquet"))
print("contains known scammers?", bitcoin.has_matches("known_scammers.parquet"))

On the fly audits

To use the slither/slitherin policies, you'll need to install some software using the following commands. Make sure the code is executing in a virtual environment. Currently can't get this to work on macOS in a virtual environment. Workin' on it

## Linux
sudo apt install software-properties-common
sudo add-apt-repository ppa:ethereum/ethereum
sudo apt install solc

Solana Contexting

## Currently only supports base64 encoded transactions

from contextooor.sol import Snippets
encoded_tx="AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAED7JuzdbW/v+WSaCB647gzQXUnhGcBdxwdoOMdnTnatmkqlXfJ6t1HVw9V1KrCNL7Kfnwxlwp4fPQgVuUFwymbvQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAe6zoCIOKahUzMQNrDc0UYuk1to62CqqaBIcWay7GjFUBAgIAAQwCAAAAgJaYAAAAAAA="

solana=Snippets(encoded_tx)
print(solana.native_transfer_value()) ## defaults to lamports
print(solana.native_transfer_value(denomination="solana"))
print(solana.native_transfer_value(denomination="usd"))