On this page
Overview
The Saphyr Chip is a physical hardware device that acts as a cryptographic key for blockchain interactions. The system demonstrates how to integrate the Saphyr Chip into web applications, enabling users to set up, verify, and use the chip for various blockchain operations.
The chip provides enhanced security by requiring physical possession of the hardware for transaction signing and authentication.
Smart Contract Interface
The Saphyr Chip interacts with the SaphyrKeyOwnerV1 smart contract deployed on the blockchain (Songbird network). The contract implements:
ownKey
Register chip ownership by linking a physical chip to a user's wallet
disownKey
Remove the association between a chip and a wallet
getOwnerByKey
Get the wallet address associated with a specific chip
getKeyByOwner
Get the chip address associated with a specific wallet
Chip Communication
The `pbt-chip-client` npm package (version 0.0.4) is used for communication with the physical chip device, handling:
Connection
Establishing connection with the chip
Key Reading
Reading the chip's public key
Signatures
Creating and verifying signatures from the chip
Blockchain Integration
The application connects to the Songbird network with the following configuration:
RPC URL
https://songbird-api.flare.network/ext/bc/C/rpc
Chain ID
19
Contract Address
0xF7442A622c572042042019d6DE42Ea043Ef4e31E
Security Considerations
Physical Security
The system relies on physical possession of the chip for authentication. Loss of the chip could result in loss of access.
Signature Verification
The smart contract verifies the chip's signature to ensure authenticity and uses blockchain data to prevent replay attacks.
Database Security
Chip public keys and signatures are stored in a PostgreSQL database. Proper database security is essential.
📚 Additional Resources
Smart Contract ABI
Access the full ABI for the SaphyrKeyOwnerV1 contract for integration purposes.
API Documentation
Complete API reference for backend integration with the Saphyr ecosystem.
SDK & Libraries
Download SDKs and libraries for popular programming languages and frameworks.