Whitepaper V1.3 Public Release
Praxifi documentation
A practical documentation system for Praxifi - Non-Custodial Financial Policy Infrastructure for Digital Wealth. It translates the approved Whitepaper V1.3 into current product behavior, boundaries, evidence, security, legal limitations, and user-facing operating guidance.
Product scope
Overview
Praxifi is a non-custodial financial policy infrastructure for digital wealth. The current public application supports MetaMask authentication, protected dashboard access, selected Base Mainnet portfolio visibility, HS-V1 diagnostics, policy configuration and review, and status/history views.
- Product status: live web application with operational application-level functionality.
- Current public policy path: Base Mainnet, chain ID 8453.
- Version 1 focuses on owner-authorized policies, not investment management or legal inheritance determination.
- Base Mainnet contract deployment is internally documented; independent audit evidence and sustained real-funds operation are not claimed.
First use
Getting Started
Users connect MetaMask, sign a scoped authentication message, review Base Mainnet configuration, inspect supported assets, and create policies only after reviewing authorization requirements.
- Supported wallet path: MetaMask wallet connection.
- Authentication: backend nonce, wallet signature, server-side verification, and protected session.
- Wallet login does not authorize asset movement.
- Users should confirm Base Mainnet, wallet address, supported token balance, recipient, amount, and allowance before activation.
- Cancelling a policy depends on policy type, current state, and available cancellation controls.
Visibility boundaries
Portfolio
Portfolio visibility is limited to Base assets currently supported by Praxifi. Portfolio visibility is not the same as automation eligibility.
- Current visibility may include Base native ETH and selected registered Base ERC-20 assets.
- Examples currently include USDC, USDT, and WETH where registered and readable.
- Complete arbitrary ERC-20 enumeration is not claimed.
- Automation eligibility is limited to USDC and USDT.
- WETH may appear in diagnostics but remains blocked from current automation execution.
HS-V1 methodology
Portfolio Healthiness
Portfolio Healthiness is experimental, heuristic, deterministic, versioned, diagnostic, non-predictive, non-advisory, not a suitability assessment, not a credit rating, and independently unvalidated.
- HS-V1 uses ten weighted categories totaling 10.00.
- Normalized score = 10 x weighted assessed contribution / assessable weight.
- Minimum assessable weight is provisionally 6.0, but it is heuristic and not a scientific boundary between good and bad portfolios.
- Missing evidence must not automatically become a risk score.
- Confidence reflects coverage, freshness, provider consistency, asset identification, historical availability, and security-data availability.
- Confidence is not a probability that the score is correct.
Owner-authorized rules
Policies
A financial policy is a narrow, owner-authorized instruction with defined parameters, lifecycle state, cancellation boundaries, eligibility checks, execution evidence, and fees only after a defined successful billable execution.
- Policy parameters include owner, network, token, amount, recipient, condition, timing, and cancellation rights where supported.
- Authorization requires wallet ownership and supported token approval where applicable.
- Lifecycle states separate draft, active, cancelled, pending execution, submitted, confirmed, failed, and refundable states where implemented.
- Execution must match the original authorized policy parameters.
Time-based policy
Scheduled Transfer
Scheduled Transfer lets an owner configure a supported stablecoin transfer for a selected future execution time, subject to approval, eligibility, cancellation, and execution evidence.
- Current automation-eligible assets: USDC and USDT.
- The user reviews token, amount, recipient, and execution time before activation.
- Failure conditions include missing approval, insufficient balance, unsupported token, cancellation, RPC failure, finality delay, or configuration mismatch.
- Fee: 0.5%, capped at USD 3, after defined successful billable execution.
Inactivity policy
Basic Inheritance
Basic Inheritance is an inactivity-triggered technical continuity policy. It does not prove death, incapacity, identity, lawful heirs, or legal entitlement.
- The owner selects a designated recipient and inactivity condition.
- Activity confirmation can renew or cancel the inactivity path where supported.
- A designated recipient is not automatically a legal beneficiary.
- Fee: 0.75%, capped at USD 25, after defined successful billable execution.
Refundable continuity
Refundable Inheritance
Refundable Inheritance adds an acceptance, refund, waiver, release, expiry, and shutdown lifecycle around a contract-controlled escrow-like state. It is implemented and internally tested, but requires separate legal and operational qualification.
- The beneficiary acceptance flow must be validated before the refundable lifecycle progresses.
- Owner refund returns control through the approved lifecycle path where conditions permit.
- Beneficiary claim and owner refund paths are separate state transitions.
- Fee: 1.0%, capped at USD 49, after defined successful billable execution.
Continuity signal
Activity Confirmation
Activity Confirmation is a Product signal used to show that the wallet owner is still active. It is not death proof, incapacity proof, identity proof, or a legal beneficiary determination.
- Current behavior relies on wallet authority and application-level confirmation.
- Password-assisted check-in may help user experience but does not recover keys.
- Replay protection, scoped messages, and chain/domain consistency remain security requirements.
- Gasless check-in remains a research boundary unless separately verified.
System components
Architecture
Praxifi separates user wallet authority, frontend review, backend coordination, smart-contract constraints, technical executor submission, Worker/Poller operations, data providers, RPC providers, notifications, audit records, and reconciliation.
- The user wallet remains the source of ownership and approval authority.
- The frontend explains and collects policy parameters; it must not hardcode contract addresses outside shared registries.
- Backend services coordinate sessions, policy records, observability, and eligibility.
- Smart contracts constrain execution to authorized parameters.
- Worker and Poller services remain operational infrastructure with PARTIAL maturity.
Base Mainnet deployment
Smart Contracts
Current project records identify Base Mainnet deployments for the Version 1 policy contracts. Deployment is not an independent audit and does not alone establish sustained Production operation.
- PraxifiInactivityExecutorV2: 0x29c6efF6D4f2687568e77E6CAA34102C92b07552
- PraxifiRefundEscrow: 0x4A0f710cEE41E1987E0f5B6601Bf1Fd229d78b82
- PraxifiScheduledTransfer: 0x35874Fd2bF16d0C7D2430BcBAae5D10547F83A56
- Network: Base Mainnet, chain ID 8453.
- Polygon policy deployment is not established in this release.
- Independent smart-contract audit is not claimed.
Worker / Poller status: PARTIAL
Execution and Operations
Execution operations include candidate selection, eligibility checks, transaction submission, idempotency, finality, retry, reconciliation, history, notifications, incident handling, gas monitoring, and executor balance monitoring.
- Worker/Poller maturity remains PARTIAL.
- Sustained Production operation, failover, SLOs, and real-funds runtime are not independently verified.
- Failed or skipped attempts should not create a Praxifi service fee.
- Execution history distinguishes submitted, provisional, finalized, failed, and cancelled evidence where supported.
Boundaries and safeguards
Security
Security is based on least privilege, owner-authorized material parameters, cancellation and renewal where available, single execution, idempotency, evidence, and explicit acknowledgement that non-custodial design does not remove risk.
- Praxifi does not receive private keys or general wallet authority.
- Approvals should be understandable and limited to supported policy requirements.
- Audit, security events, execution proofs, and monitoring are observability layers, not guarantees.
- Security-related reports: praxifi.official@gmail.com
Risks are documented, not eliminated
Threat Model
The public threat model groups risks across user wallets, execution infrastructure, smart contracts, token behavior, pricing/data providers, and operations.
- User / Wallet: wallet compromise, wallet loss, recipient-address error, malicious frontend, session hijacking, password compromise, signature replay, chain/domain mismatch.
- Execution: executor-key compromise, executor censorship, executor downtime, Worker failure, Poller failure, RPC failure, RPC inconsistency, chain reorganization, insufficient finality, gas shortage, duplicate execution.
- Smart Contract: contract vulnerabilities, approval misuse, unlimited allowances, timestamp assumptions, upgrade authority, pause authority.
- Token / Stablecoin: issuer freeze, blacklist, pause, depeg, token incompatibility, decimals, rounding, fee-on-transfer, rebasing, non-standard behavior.
- Pricing / Data: oracle manipulation, stale pricing, provider poisoning, incomplete portfolio data.
- Operations: notification failure, service shutdown, dependency compromise, privacy leakage, treasury compromise, gas-price spike.
Execution-fee model
Fees and Economics
Praxifi uses an execution-fee model for supported policies. There is no subscription, native Praxifi token, or separate payment gateway required for the current model.
- Gross amount = net recipient amount + service fee.
- Fee is intended to settle from transferred principal.
- Fee applies only after the defined successful billable execution.
- Gas and external costs remain separate.
- Pricing, depeg, and oracle Production specifications remain qualified.
Base Mainnet current path
Supported Networks and Assets
The current public network is Base Mainnet, chain ID 8453. Polygon is planned Version 1 scope, not current deployed policy availability.
- Portfolio visibility: Base native ETH and selected registered Base ERC-20 assets.
- Portfolio examples: USDC, USDT, WETH.
- Automation eligibility: USDC and USDT only.
- WETH and unsupported assets are not currently automation eligible.
- Unknown assets and complete arbitrary ERC-20 wallet enumeration are not claimed.
Not legal advice
Legal and Regulatory Boundaries
Praxifi documentation describes technical controls and Product boundaries. It does not determine legal classification, compliance, entitlement, succession, tax treatment, or cross-border availability.
- Technical control is not the same as legal ownership.
- Technical execution is not the same as legal entitlement.
- Inactivity is not death or incapacity proof.
- Designated recipient does not mean lawful beneficiary.
- Custody, safeguarding, payment/transfer-service exposure, crypto-asset service classification, AML/CFT/sanctions, consumer protection, privacy, tax, reporting, and cross-border availability remain jurisdiction-specific uncertainties.
Maturity labels
Product Status and Evidence
Status labels separate public availability, application operation, internal testing, local-chain validation, Mainnet deployment, Mainnet operation, independent validation, and unsupported future scope.
- Live means publicly accessible at application level, not Mainnet or Production readiness.
- Mainnet deployed means a specified contract exists on the stated Mainnet; it does not imply sustained safe operation.
- Independent audit completed is not claimed in this release.
- Mainnet operational is not claimed unless separately supported by evidence.
What Praxifi does not do
Product Limitations
Praxifi has explicit Product boundaries that should remain visible in public documentation and user-facing copy.
- Does not recover, recreate, or custody private keys.
- Does not prove death, incapacity, identity, lawful heirs, or legal inheritance.
- Does not guarantee execution, returns, safety, or portfolio improvement.
- Does not manage investments or automatically execute investment advice in Version 1.
- Does not support every wallet, token, or network.
- Does not claim independent validation, independent smart-contract audit, or global legal compliance.
Future capabilities are future scope
Roadmap
The roadmap should help readers understand future direction without presenting future phases as currently available.
- Phase 1: Public Release and Evidence Maintenance.
- Phase 2: Mainnet Operational Verification.
- Phase 3: Refundable Continuity Hardening.
- Phase 4: Financial Policy Engine.
- Phase 5: Advanced Portfolio Intelligence and Capital Allocation Research.
PraxiHub relationship
Research Foundations
PraxiHub may inform and challenge Praxifi assumptions, but it is not a regulator, auditor, certification body, legal authority, or automatic independent verifier.
- Digital Asset Continuity: practical access and intent execution for digital assets.
- Autonomous Wealth: owner-authorized policies rather than unrestricted automation.
- Rule-Based Finance: narrow rules with understandable parameters.
- Resilient Financial Infrastructure: monitoring, evidence, failure handling, and recovery boundaries.
- Programmable Portfolio Intelligence: diagnostics that explain data without becoming advice.
- Capital Allocation Research: future research, not current investment-management functionality.
Qualified definitions
Terminology
Documentation terminology should preserve the Whitepaper's qualifications and avoid turning technical labels into legal or financial claims.
- Owner: wallet user authorizing a policy.
- Designated Recipient: technical recipient selected by the owner; not automatically a lawful beneficiary.
- Technical Transaction Executor: infrastructure allowed to submit eligible transactions within contract constraints.
- Financial Policy: a narrow owner-authorized rule for a defined digital-asset action.
- Continuous Ownership: continued user authority and activity signaling, not legal proof.
- Digital Asset Continuity: practical continuity of digital-asset access and intent execution.
- Basic Inheritance: inactivity-triggered technical transfer policy.
- Refundable Inheritance: refundable continuity lifecycle with escrow-like contract-controlled state.
- Check-in: activity confirmation signal.
- Exact Allowance: approval sized to the required policy amount where supported.
- Coverage: portion of portfolio evidence available for assessment.
- Confidence: data-quality signal, not probability of correctness.
- Production Verification: evidence that a deployed system is operating under defined controls.
Official channel
Contact
Use the official Praxifi email for general contact and security-related reports. This does not imply continuous support coverage or a dedicated security response team.
- General contact: praxifi.official@gmail.com
- Security-related reports: praxifi.official@gmail.com
Portfolio Health
Portfolio Healthiness
A transparent analytical score from 0 to 10 that evaluates available supported portfolio evidence on the current Base Mainnet public application path.
What Portfolio Healthiness Is
Portfolio Healthiness evaluates observable portfolio risks using supported on-chain wallet data, verified token identity, market enrichment, security signals, and data-confidence controls. It does not predict returns, provide financial advice, or guarantee safety.
Unsupported, undiscovered, unpriced, stale, or unavailable evidence may reduce coverage and confidence. A high score does not mean losses are impossible, and a missing score does not mean the wallet has no value.
Why These Criteria Were Selected
The individual risk concepts are established in portfolio management, market-risk analysis, and blockchain security. Praxifi combines these concepts into its own explainable 10-point framework.
The framework combines diversification, concentration, liquidity, volatility, drawdown, leverage, issuer risk, smart-contract risk, token-contract risk, approval risk, wallet exposure, and data quality. Category weights and thresholds are Praxifi's product methodology and may be refined as coverage and validation improve.
Criteria and Weights
| Criterion | Weight |
|---|---|
| Diversification | 1.50 |
| Asset Quality | 1.50 |
| Concentration Risk | 1.00 |
| Liquidity | 1.00 |
| Wallet and Asset Security | 1.50 |
| Stablecoin and Cash Reserve Risk | 1.00 |
| Smart Contract and Protocol Risk | 1.00 |
| Market Risk and Volatility | 0.75 |
| Leverage and Liquidation Risk | 0.50 |
| Portfolio Management Discipline | 0.25 |
| Total | 10.00 |
Each criterion documents what it measures, why it matters, inputs used, data sources, scoring method, limitations, and educational actions in the dashboard category details.
Data Sources
- Blockchain RPC is used for wallet balances, token balances, contract reads, allowance verification, and supported on-chain positions. Direct on-chain data is preferred when practical.
- CoinGecko is used for current prices, market capitalization, volume, historical prices, historical volume, metadata, volatility, drawdown, and liquidity indicators.
- DefiLlama is used for protocol TVL, historical TVL, categories, fees and revenue where available, and stablecoin metadata. TVL is one contextual indicator and is not proof of protocol safety.
- GoPlus Security is used for token security signals, malicious address signals, approval risk, dApp security, and contract restrictions.
- Supported explorers may optionally support transfer data, transaction history, contract metadata, and verification data.
External provider data may be delayed, incomplete, unavailable, or incorrect.
Portfolio Asset Discovery
Status: operational within supported scope. Portfolio diagnostics may display Base native ETH and selected supported or registered Base ERC-20 assets, including currently known examples such as USDC, USDT, and WETH.
Complete arbitrary ERC-20 wallet enumeration is not currently supported or claimed. Portfolio visibility is separate from automation eligibility; automation execution is currently restricted to USDC and USDT.
Calculation Process
Connected wallet → on-chain asset discovery → token identity verification → USD valuation → market and protocol enrichment → security analysis → category scoring → data-confidence calculation → score normalization → findings and remediation actions.
The raw score is the sum of scored framework points. Maximum assessable score is the currently measurable framework weight. Unavailable score is the framework weight that could not be assessed. Normalized score scales assessed points to a 10-point view when at least 6.0 framework points are assessable. If data confidence is below 60%, Healthy and Excellent presentation statuses are gated, but the numeric normalized result is not secretly changed.
Missing and Unsupported Data
Unknown tokens are not silently treated as worthless, and they are not automatically classified as scams. Unsupported protocols are not fully assessed. Native valuation may be unavailable where mapping is not yet supported. Manual behavioral and custody data is not inferred.
Ordinary holdings are not assumed to be unleveraged merely because no adapter detected leverage. A score is withheld when coverage is insufficient.
Limitations
Current limitations include API outages, provider rate limits, indexing delays, metadata errors, rapid market changes, new contracts, unsupported protocols, bridges, cross-chain positions, NFTs, LP tokens, lending positions, leveraged products, private or off-chain assets, smart-contract risks not detected automatically, seed phrase practices, hardware wallet practices, shared-wallet behavior, incomplete approval coverage, and in-memory cache limitations.
How Users Can Improve Each Area
Educational actions may include reviewing single-asset concentration, reviewing chain concentration, reviewing unknown tokens, revoking unnecessary approvals using trusted tools, reviewing stablecoin issuer exposure, reviewing DeFi protocol dependencies, maintaining sufficient liquidity, verifying token contract addresses, avoiding unsupported high-leverage positions, and reviewing protocol upgrade/admin risks.
Praxifi does not recommend buying or selling specific assets and does not provide personalized financial advice.
Methodology Version
- Version
- 1.0.0
- Framework ID
- praxifi-portfolio-health
- Last updated
- 2026-07-18
- Current public path
- Base Mainnet
- Planned scope
- Polygon remains planned scope and is not part of the current deployed policy path.
- Providers
- Blockchain RPC, CoinGecko, GoPlus Security, DefiLlama, Internal Registry
Portfolio Healthiness is an analytical risk indicator, not financial advice, a guarantee of safety, or a prediction of future returns.
HS-V1 Categories and Weights
Total model weight is 10.00. The model is diagnostic and must be interpreted with coverage and confidence.
| Category | Weight | Version 1 purpose |
|---|---|---|
| Diversification | 1.50 | Portfolio spread and concentration evidence. |
| Asset evidence quality | 1.50 | How much asset evidence is identified and usable. |
| Concentration exposure | 1.00 | Large single-asset or narrow exposure signals. |
| Liquidity evidence | 1.00 | Available liquidity and market evidence where supported. |
| Wallet and token security signals | 1.50 | Wallet, token, approval, and security-data signals. |
| Stablecoin and reserve exposure | 1.00 | Stablecoin, reserve, and issuer-risk evidence. |
| Protocol and smart-contract exposure | 1.00 | Protocol and contract dependency evidence. |
| Market volatility and drawdown evidence | 0.75 | Historical volatility and drawdown evidence where available. |
| Leverage and liquidation exposure | 0.50 | Leverage, liquidation, or debt-like exposure signals. |
| Operational policy readiness | 0.25 | Readiness of configured policies and operational controls. |
Fee Schedule
Gross amount = net recipient amount + service fee. Failed or skipped actions should not create a Praxifi service fee.
| Policy | Fee | Cap | Fee trigger |
|---|---|---|---|
| Scheduled Transfer | 0.5% | USD 3 | Defined successful billable scheduled transfer execution. |
| Basic Inheritance | 0.75% | USD 25 | Defined successful billable inactivity-policy execution. |
| Refundable Inheritance | 1.0% | USD 49 | Defined successful billable refundable lifecycle execution. |
Contract Register
Canonical deployed contract references for the current Base Mainnet policy path. Polygon deployment is not claimed.
| Contract | Address | Network |
|---|---|---|
| PraxifiInactivityExecutorV2 | 0x29c6efF6D4f2687568e77E6CAA34102C92b07552 | Base Mainnet / 8453 |
| PraxifiRefundEscrow | 0x4A0f710cEE41E1987E0f5B6601Bf1Fd229d78b82 | Base Mainnet / 8453 |
| PraxifiScheduledTransfer | 0x35874Fd2bF16d0C7D2430BcBAae5D10547F83A56 | Base Mainnet / 8453 |
Capability Status Register
Status labels separate live application behavior, internal evidence, Mainnet deployment, and independent validation.
| Capability | Status | Evidence boundary |
|---|---|---|
| Praxifi Web Application | Live | Public web application is accessible; this is not independent proof of on-chain Production operation. |
| MetaMask authentication | Operational | Nonce issuance, wallet-signature verification, and protected sessions are implemented. |
| Base Mainnet | Current public network | Current policy path is Base Mainnet, chain ID 8453. |
| Polygon | Future version | Planned Version 1 scope only; not current deployed policy path. |
| Portfolio Asset Discovery | Operational within supported scope | Native ETH and selected registered Base ERC-20 assets may be visible; arbitrary ERC-20 enumeration is not claimed. |
| USDC | Automation eligible | Supported for current automation execution. |
| USDT | Automation eligible | Supported for current automation execution. |
| WETH | Portfolio-visible where registered; automation blocked | May appear in diagnostics, but is not automation eligible. |
| Portfolio Healthiness | Operational; independently unvalidated | HS-V1 is experimental, heuristic, deterministic, versioned, diagnostic, non-advisory, and non-predictive. |
| Scheduled Transfer | Mainnet deployed on Base; application review available | Real-funds operational execution and independent audit are not independently verified. |
| Basic Inheritance | Mainnet deployed on Base; application flow implemented | Legal inheritance is not determined by Praxifi. |
| Check-in | Implemented | Used as an activity confirmation signal; inactivity is not death or incapacity proof. |
| Password-assisted Check-in | Implemented with qualifications | Assists activity confirmation; it does not recover keys or prove identity. |
| Refundable Inheritance | Implemented and internally tested | Contract-controlled escrow-like states require separate risk and legal analysis. |
| Exact Allowance | Implemented | Approval should match required policy amount where supported. |
| Cancellation | Implemented where supported | Cancellation depends on policy state and authorized controls. |
| Executor | Implemented with restrictions | Executor is technical transaction submission infrastructure, not custody. |
| Worker/Poller | PARTIAL | Sustained Production operation, failover, SLOs, and real-funds runtime remain independently unverified. |
| Execution History | Implemented | Shows application evidence and lifecycle records where available. |
| Notifications | Implemented at application level | External delivery reliability remains separately qualified. |
| Monitoring | Implemented foundation | Production monitoring evidence remains separate from application availability. |
| Fee Settlement | Implemented and internally tested | Production economic edge cases and sustained real-funds settlement are not independently verified. |
| Social Recovery | Blocked dependency | Not current Product path. |
| Private-Key Recovery | Not currently supported | Praxifi does not recover or recreate private keys. |
| Multi-Wallet | Future version | Not current public Product path. |
| Portfolio Automation | Future version | Version 1 does not manage investments or execute investment advice. |
| Capital Allocation Research | Research-stage | Research foundation only, not Product proof. |
| Native Token | Removed / not currently supported | No Praxifi token is required for current fee model. |
| Subscription | Not currently supported | Current model is execution-fee based, not subscription based. |
| Payment Gateway | Not currently supported | No separate payment gateway is required for the current model. |
| Mainnet Real-Funds Operation | Production verification pending | Sustained real-funds operation is not independently verified. |
| Independent Smart-Contract Audit | Independent validation pending | No independent audit is claimed in this release. |
Documentation Coverage Matrix
Whitepaper V1.3 areas are represented in the public Documentation either as complete practical guidance or as an intentional summary with boundaries.
| Whitepaper area | Documentation location | Coverage |
|---|---|---|
| Product Thesis | Overview / Research Foundations | Full |
| Research Pillars | Research Foundations | Full summary |
| Product Model | Overview / Policies | Full |
| Portfolio Healthiness | Portfolio / Portfolio Healthiness | Full |
| Scheduled Transfer | Policies / Scheduled Transfer | Full |
| Basic Inheritance | Policies / Basic Inheritance | Full |
| Refundable Inheritance | Policies / Refundable Inheritance | Full |
| Architecture | Architecture | Full |
| Worker/Poller | Execution and Operations | Full with PARTIAL status |
| Security | Security | Full summary |
| Threat Model | Threat Model | Full category coverage |
| Legal | Legal and Regulatory Boundaries | Full summary |
| Economics | Fees and Economics | Full |
| Governance | Product Status and Evidence / Security | Summarized with boundaries |
| Roadmap | Roadmap | Full summary |
| Risks | Threat Model / Product Limitations | Full summary |
| Terminology | Terminology | Full glossary |
| Evidence | Product Status and Evidence | Full |

