Back

🚀 Developer Hub

Start integrating quantum security in minutes

SDK v1.0.0 Available View on npm Updated: Dez 2025

Quick Start Guide

1

Install the SDK

📦 Installation via npm:

npm install allianza-qss-js

✅ SDK Available on npm

The allianza-qss-js@1.0.0 package is available on npm! Install now and start using quantum security in your projects.

View on npm

🔧 Alternative: Direct REST API

// JavaScript Example (REST API) const response = await fetch('https://testnet.allianza.tech/api/qss/generate-proof', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ chain: 'bitcoin', tx_hash: '...' }) }); const proof = await response.json();
2

Generate Quantum Proof

import QSS from 'allianza-qss-js'; // Generate proof for any blockchain const proof = await QSS.generateProof('bitcoin', txHash); console.log('Proof Hash:', proof.proof_hash);

Funciona com Bitcoin, Ethereum, Polygon, BSC, Solana, Avalanche, Base e qualquer blockchain!

3

Verificar a Prova

const result = await QSS.verifyProof(proof); if (result.valid) { console.log('✅ Prova válida!'); console.log('Assinatura ML-DSA:', result.verification_details.signature_valid); console.log('Merkle Proof:', result.verification_details.merkle_proof_valid); }
4

Anchor on Blockchain

Bitcoin (OP_RETURN):

const instructions = await QSS.anchorOnBitcoin(proof, 'tb1q...'); // Use instructions.data in OP_RETURN

Ethereum/Polygon (Smart Contract):

const { transactionData } = await QSS.anchorOnEVM( proof, contractAddress, 'ethereum' ); // Envie a transação com transactionData

REST API Examples

Generate Proof

POST https://testnet.allianza.tech/api/qss/generate-proof Content-Type: application/json { "chain": "bitcoin", "tx_hash": "842f01a3302b6b19981204c96f377be1..." }

Verify Proof

POST https://testnet.allianza.tech/api/qss/verify-proof Content-Type: application/json { "quantum_proof": { /* JSON da prova */ } }

Anchor Proof

POST https://testnet.allianza.tech/api/qss/anchor-proof Content-Type: application/json { "quantum_proof": { /* JSON da prova */ }, "target_chain": "bitcoin", "target_address": "optional" }

Service Status

GET https://testnet.allianza.tech/api/qss/status

Use Cases

Cross-Chain Bridges

Prove that a Polygon transaction was validated and anchor it on Bitcoin.

Exchanges

Generate quantum proofs for withdrawals and verify before processing.

DeFi Protocols

Protect smart contract interactions with quantum proofs.

audit

Certify important transactions with verifiable proofs.

allianza_native_chain

architecture

Allianza Blockchain é uma blockchain nativa com arquitetura de sharding dinâmico e consenso adaptativo.

  • Dynamic Sharding: Escala automaticamente de 4 a 1000 shards conforme a demanda
  • Adaptive Consensus: Otimiza performance e segurança automaticamente (10-50x mais rápido em alta carga)
  • Quantum-Safe Signatures: ML-DSA (Dilithium), ML-KEM (Kyber), SPHINCS+ via liboqs-python
  • Bridge-Free Interoperability: ALZ-NIEV protocol (Zero-Knowledge Proofs + State Commitments)

running_a_node

Para rodar um nó validador ou de retransmissão na Allianza Testnet:

# Clone o repositório git clone https://github.com/allianzatech/blockchainallianza.git cd blockchainallianza # Instale dependências pip install -r requirements.txt # Execute o nó python allianza_blockchain.py

Para acesso completo ao código de produção (incluindo testnet), consulte o repositório privado comercial.

smart_contracts

Allianza suporta smart contracts com assinaturas quântico-seguras. A documentação completa de smart contracts está disponível no repositório comercial.

pqc_status_notice

Na testnet atual, o sistema de criptografia pós-quântica está em modo simulado para fins de demonstração e desenvolvimento.

Status Atual:

  • liboqs-python: Simulado (emulando ML-DSA, ML-KEM, SPHINCS+)
  • Quantum Proofs: Funcionais (estrutura completa, verificação matemática real)
  • ALZ-NIEV Protocol: Operacional (ZK Proofs + State Commitments reais)

Produção PQC Real: A implementação completa com liboqs-python real será disponibilizada na mainnet. O cronograma será anunciado através dos canais oficiais.

Resources