Open-source security framework for blockchain applications

Bloxchain Protocol

No single key can move assets alone

Open-source framework so every critical on-chain action can require multiple approvals and a time delay. Build secure smart contracts with multi-step workflows, separate signer and executor roles, and time-locked operations. For developers and teams who need strong security without a single point of failure.

Core library

Bloxchain engine

License

Open Source

MPL-2.0

Security model

Multi-Phase

Time-Locked

Status

Live on Testnet

Security Framework

Core Security Features

Open-source framework with multi-phase transaction lifecycle control, time-locked operations, and the Bloxchain engine for secure blockchain applications.

What makes Bloxchain unique

Runtime access control

Roles and permissions are configurable at runtime, not fixed at deploy. Add or change roles without upgrading the contract.

Transaction lifecycle workflows

Multi-phase, multi-role workflows: time-delayed (request → wait → approve) and gasless (separate signer and executor). No single step can execute alone.

Integrated security

Built-in ownership and recovery management. Admin, executor, and recovery roles are part of the design, not bolted on.

Fine-grained access control

Control which external contracts can be called, per action. You decide what is allowed; nothing is allowed by default.

Fully runtime configurable

Security settings, roles, and allowed targets can be changed at runtime. No contract upgrade required.

Self-contained

Single contract with no external protocol dependencies. Simpler deployment, upgrade path, and audit.

Bloxchain engine

The core library that powers multi-phase workflows and the state machine. Security policies and roles can be adjusted without contract upgrades.

Predictable workflowsRuntime PoliciesScalable Architecture

Multi-Phase Security

Request, wait, then approve — with distinct phases so no single step can execute alone. Separate roles for signing and executing, time delays, and cryptographic verification at each stage.

Multi-Phase LifecycleSeparate signer & executorTime-Locked Execution

Controlled external calls

Secure gateway for calling other contracts. You choose which contracts can be called for each action; nothing is allowed by default. Every external call can use time delays and gasless execution, so no single key can delegate unchecked.

Runtime access definitionTarget whitelistingDefense-in-depthTime-lock & gasless workflowsPer-action permissions

You define which external contracts are allowed for each action; by default nothing is allowed. Used by the programmable account template and Bloxchain Wallet.

Roles & access

Role-Based Access Control

Predefined admin, executor, and recovery roles. Add or change roles at runtime for flexible access control.

Time-Locked

Time-Locked Operations

Configurable time delays with intervention windows to prevent malicious activities.

Recovery

Recovery Built In

Built-in security workflow to protect critical recovery (transfer ownership) operations.

Build on Built-in Security

Ownership, recovery, and time-locks are built in — inherit them instead of building from scratch. Use the open-source SDK and docs to integrate quickly.

Simple Inheritance

Get ownership, recovery, and time-locks by extending a template; focus on your logic.

TypeScript SDK

Type-safe integration, gasless execution helpers, and documentation.

Protocol Architecture

Bloxchain Protocol architecture

Modular architecture with the Bloxchain engine at the core. Choose foundation, roles, or programmable account for multi-phase security, runtime roles, and controlled external calls.

Implementation Options

Choose Your Blox Implementation

Three levels: foundation (minimal), roles (multi-phase and runtime roles), and programmable account (controlled external calls for wallets and delegation).

Foundation

BaseBlox

Minimal

Minimal foundation — core workflow engine only. For developers who need full control over security patterns and custom workflows.

Bloxchain engine (EngineBlox)

Pre-defined roles, no workflows

Custom security patterns

Core

// Minimal - BaseStateMachine only
contract MyContract is BaseBlox { ... }

Runtime roles

RoleBlox

Multi-phase + RBAC

Multi-phase security plus runtime role management. For enterprise systems and DAOs that need runtime-configurable access control and custom roles without contract upgrades.

All BaseBlox features +

Multi-phase workflows

Runtime role management

Custom role creation

Runtime

// Multi-phase + runtime roles
contract MyContract is RoleBlox { ... }

Programmable account

AccountBlox

Controlled external calls

Everything in RoleBlox plus controlled external calls: the template for programmable wallets and secure delegation. You choose which contracts can be called for each action; time delays and gasless execution apply to every external call. Bloxchain Wallet is built on this template.

All RoleBlox features +

Target whitelisting per function

Controlled external contract calls

Defense-in-depth for delegation

Account

// Programmable wallet / controlled external calls
contract MyContract is AccountBlox { ... }

Development Guide

Implementation & Getting Started

Step-by-step guide to implement Bloxchain Protocol: install the SDK, choose your blox, and deploy. See the protocol repo for full documentation.

Install the SDK and contracts

Use the official npm packages for TypeScript integration and contract imports. Documentation is in the protocol repo (sdk/typescript/docs) and on GitHub.

Terminal

npm install @bloxchain/sdk @bloxchain/contracts

Clone the repository (optional)

Clone the Bloxchain Protocol repo for full source, examples (SimpleVault, SimpleRWA20, PayBlox, GuardianSafe), and local development.

Terminal

git clone https://github.com/PracticalParticle/Bloxchain-Protocol.git

Choose your blox

Pick foundation (minimal), roles (multi-phase and runtime roles), or programmable account (controlled external calls for wallets and delegation).

Terminal

// Templates:
// BaseBlox - minimal
// RoleBlox - multi-phase + runtime roles
// AccountBlox - + controlled external calls

Implement your logic

Write your business functions using the inherited security patterns. The Bloxchain engine handles multi-signature validation, role-based access control, and time-lock enforcement.

Terminal

// Example: SimpleVault with time-locked operations
contract SimpleVault is SecureBlox {
    // Time-locked ETH withdrawal request
    function withdrawEthRequest(address to, uint256 amount) public onlyOwner returns (StateAbstraction.TxRecord memory) {
        // Creates time-locked withdrawal request
        // Requires approval after time-lock period
    }
    
    // Standard approval workflow (after time delay)
    function approveWithdrawalAfterDelay(uint256 txId) public onlyOwner returns (StateAbstraction.TxRecord memory) {
        // Approves withdrawal after mandatory time-lock period
        // Requires owner role permission
    }
    
    // Meta-transaction approval workflow (gasless)
    function approveWithdrawalWithMetaTx(StateAbstraction.MetaTransaction memory metaTx) public onlyBroadcaster returns (StateAbstraction.TxRecord memory) {
        // Approves withdrawal using meta-transaction
        // Requires broadcaster role execution with off-chain signature
    }
}

Deploy and test

Deploy to Sepolia testnet or use SandBlox for interactive testing. Configure security parameters, roles, and access controls for your implementation.

Terminal

# Deploy to Sepolia testnet
npx hardhat run scripts/deploy.js --network sepolia

# Or use SandBlox for interactive testing
# Visit: https://sandblox.app/

# Local testing
npm run deploy:hardhat

Ready to implement Bloxchain Protocol?

Choose your preferred method to begin building with the security framework

Not yet audited; recommended for testnets and evaluation. Formal verification and security audit planned.

Enterprise-gradeOpen source (MPL-2.0)EVM compatibleTypeScript SDK

Use Cases

Powering Blockchain Applications

Bloxchain Protocol powers secure blockchain applications across DeFi, enterprise, governance, and AI agent frameworks — with multi-phase workflows, runtime roles, and controlled external calls for safe on-chain automation.

DeFi Protocols

Secure multi-signature workflows for protocol governance, treasury management, and critical parameter updates.

Enterprise Applications

Role-based access control for enterprise blockchain applications with compliance-ready audit trails.

DAO Governance

Decentralized governance with multi-phase approval processes and cryptographic verification.

AI Agent Frameworks

Secure AI agents for blockchain automation with multi-approval workflows and delays to prevent unauthorized actions.

Benefits

Why choose Bloxchain Protocol?

Open-source framework with three tiers: foundation for custom patterns, roles for multi-phase and runtime access, programmable account for wallets and controlled external calls.

Modular architecture with clear separation of concerns

Simple inheritance — choose foundation, roles, or programmable account templates

Ready-to-use security patterns with comprehensive testing

Add or change roles without upgrading contracts

Gasless approvals with separate signer and executor roles

Self-contained: single contract, no external protocol dependencies — simpler deployment and audit

Documentation and examples included

Bloxchain Protocol

Open-source framework with three tiers: foundation for custom patterns, roles for multi-phase and runtime access, programmable account for wallets and controlled external calls.

100%

Open Source

Modular

Architecture

Expanding the Protocol

Follow & Contribute to the Protocol

Bloxchain Protocol is designed to grow with additional contract types, security patterns, and ecosystem integrations.

Coming Soon

More Contract Types

Additional Blox implementations for DeFi protocols, NFT marketplaces, and governance systems.

Expandable Framework

In Development

Enhanced Security

Advanced security libraries and formal verification tools for smart contract correctness.

Formal Verification

More Products

Explore our complete product suite

SandBlox

Live

Bloxchain.app

Coming Soon

Bloxchain Wallet

Testnet