1btc Chat API

Overview

The 1btc Chat API is a critical component of the 1btc Chat platform, a unique community designed for Bitcoin holders with at least 1 Bitcoin. This API underpins the platform's innovative wallet-first approach, where a user's cryptocurrency address serves as their login identity, offering an added layer of pseudonymity, privacy, and security.

By automating the verification process, the API facilitates a dust transaction method to cryptographically link user accounts and confirm ownership of at least 1 Bitcoin.

This API also allows for independent verification of all relevant data, ensuring transparency and integrity within the 1btc Chat community.

Endpoints

System Info

GET https://1btc-api.console.xyz/

Returns network information and minimum valid BTC balance.

200: OK

{
    network: string, // "testnet" | "mainnet"
    minValid: string // big number with 8 decimals
}

Account Info

GET https://1btc-api.console.xyz/account/:address

Returns the owner address, randomly generated receive address, origin, and status.

Path Parameters

Name	Type	Description
address*	String	wallet address to check

200: OK

{
    owner: string,                      // owner hiro wallet address (maybe evm, solana... in the future)
    receiveAddress: string,             // randomly generated bitcoin adress to deposit dust amount
    origin: string | undefined | null,  // the detected bitcoin address sent dust amount to receiveAddress
    status: string                      // "pending" | "valid" | "insufficient" | "duplicate"
                                        //   pending => waiting for the dust amount
                                        //   valid => origin balance gte minValid
                                        //   insufficient => origin balance lt minValid
                                        //   duplicate => origin address already used to verify an account
}

404: Not Found

Request Message

POST https://1btc-api.console.xyz/get-hiro-signature-message

Generates a new signature message for a wallet address.

Request Body

Name	Type	Description
wallet*	String	wallet address

200: OK

{
    msg: string // message to use for signature request from the user
}

400: Bad Request

Register Account

POST https://1btc-api.console.xyz/register-hiro

Registers new account using Hiro wallet signature and public key.

Request Body

Name	Type	Description
signature*	String
publicKey*	String

200: OK

{
    owner: string,                      // owner hiro wallet address (maybe evm, solana... in the future)
    receiveAddress: string,             // randomly generated bitcoin adress to deposit dust amount
    origin: string | undefined | null,  // the detected bitcoin address sent dust amount to receiveAddress
    status: string                      // "pending" | "valid" | "insufficient"
                                        //   pending => waiting for the dust amount
                                        //   valid => origin balance gte minValid
                                        //   insufficient => origin balance lt minValid
                                        //   duplicate => origin address already used to verify an account
}

400: Bad Request