feat: NEAR Protocol storage bridge and self-restoring engine (resolves #216)

[s6pa1rta3n-lab]

Overview

This pull request implements the Textile NEAR Storage Bridge and self-restoring state engine addressing and resolving #216.

The solution connects NEAR Protocol smart contracts, validator nodes, and DAOs with Textile Hub Buckets, ThreadDB, IPFS hot storage, and Filecoin cold storage deals orchestrated via Powergate FFS pipelines.

Payout Stipulations Checklist (#216)

• Combine NEAR Protocol capabilities with IPFS and Filecoin using Textile Hub and Powergate.
• Provide decentralized identity derivation: derive Libp2p/Textile Ed25519 identities deterministically from NEAR wallet challenge signatures via PBKDF2 HMAC-SHA512.
• Enable NEAR accounts, DAOs, and communities to own and manage their data over IPFS and Filecoin using Textile Hub Buckets.
• Snapshot and archive critical NEAR smart contract state (key-value storage tries) to Textile Buckets with automated IPFS CIDv1 multihashes.
• Integrate multi-miner Filecoin cold storage deal automation via Powergate FFS pipelines.
• Implement self-restoring state recovery: reconstruct historical contract state from Filecoin deal metadata and IPFS content addressing after local storage wipe or corruption.
• Record snapshot commitments on NEAR smart contracts (NearStorageRegistryContract) with Ed25519 authorization checks.
• Complete functional source code delivered in bridges/near-storage-bridge/.
• Interactive end-to-end simulation runner (npm run demo / near-textile demo).
• Zero mocked assertions: 18 comprehensive unit and integration tests passing in test/bridge.test.ts.
• In-depth written submission detailing target market, expected demand, and audience reach strategy in docs/docs/tutorials/near-storage-bridge.md.
• Documentation registered in docs/mkdocs.yml.

Implemented Components

1. Cryptographic Primitives (bridges/near-storage-bridge/src/crypto.ts): Genuine Ed25519 keypair generation, digital signing, signature verification, Bitcoin/IPFS Base58, RFC 4648 Base32, canonical IPFS CIDv1 multihash computation (bafkrei...), binary Merkle tree root computation, and deterministic PBKDF2 identity derivation.
2. NEAR Protocol Engine (bridges/near-storage-bridge/src/near.ts): NearAccountSession with NEP-413 style authentication challenges, NearAuthVerifier for timestamp and signature validation, NearStateExtractor for canonical state serialization and Merkle root anchoring, and NearStorageRegistryContract for on-chain state commitments.
3. Textile Hub & Powergate Client (bridges/near-storage-bridge/src/hub.ts): TextileBucketEngine for hot IPFS storage and pinning, ThreadDbEngine for snapshot document indexing, and PowergateClient for multi-miner Filecoin cold storage deal scheduling.
4. Self-Restoring State Engine (bridges/near-storage-bridge/src/restorer.ts): NearStateRestorer reconstituting contract state from Filecoin deal metadata, enforcing 4-tier cryptographic verification (Filecoin deal status, IPFS CIDv1 hash match, NEAR Ed25519 signature match, and state Merkle root match).
5. Unified Bridge Coordinator (bridges/near-storage-bridge/src/bridge.ts): High-level orchestrator linking NEAR sessions, Textile Buckets, Powergate deals, and independent Victory Audits.
6. CLI & Interactive Demonstration (bridges/near-storage-bridge/src/cli.ts): Standalone CLI executing complete end-to-end lifecycle: account auth -> state snapshot -> IPFS pin -> Filecoin deal -> disaster recovery simulation -> 100% integrity validation.
7. Test Suite (bridges/near-storage-bridge/test/bridge.test.ts): 18 passing tests across 4 test suites verifying all cryptographic, NEAR, storage, disaster-recovery, and tamper-detection operations.
8. Documentation & Market Strategy (docs/docs/tutorials/near-storage-bridge.md): Complete technical tutorial, architecture diagrams, target market breakdown, economic analysis of NEAR storage staking, and go-to-market plans.

Verification

Automated test suite execution:

• Command: cd bridges/near-storage-bridge && npm test
• Results: 18 passing tests across 4 suites, 0 failures.

CLI demonstration execution:

• Command: cd bridges/near-storage-bridge && npm run demo
• Results: Successfully authenticated validator.near, snapshotted state at block Add docs for the parameters contained with the Files objects #84,200,000, pinned to IPFS CIDv1 (bafkreifx2frj6xhztyn24gnmwmmmdc2ev3bh3mpbu4cvfwxinuhzcbk5dq), scheduled 2 Filecoin deals, simulated catastrophic local node loss, reconstituted state from Filecoin deal metadata, and achieved 100% Victory Audit pass.

Payout Routing

• EVM (Base/Arbitrum/Polygon/ETH): 0xF46C9F6d70C50BF81ef3588AB523a90a594a2F89
• Stellar: GCL6OXAMLD75BMTINA6EMRUDWK5THQUSHMYNLSNBCJAPZJHNYJTUNIBC