src/Readme.md

1P Wallet

A Streamlit app implementing a 2FA-like visual authentication for Aptos wallets.

Quick start (dev/testnet):

1. Create a virtualenv and install deps:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Set required environment variables (for full functionality):

export APTOS_ACCOUNT=0x...       # system wallet address
export APTOS_PRIVATE_KEY=...     # system wallet private key (hex)

3. Run the app:

streamlit run app.py

Notes:

• This project is for demonstration. Do not use the provided scripts in production without proper key management.
• Use scripts/verify_env.sh to confirm environment variables are present.

Notes from runtime:

• Streamlit recommends installing watchdog for better file-change performance (pip install watchdog).
• It is recommended that private keys are AIP-80 compliant: https://github.com/aptos-foundation/AIPs/blob/main/aips/aip-80.md
• For the one-click browser localStorage save/restore feature, install streamlit-javascript:

  pip install streamlit-javascript