OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Payments & Stablecoins

One Time Address

One Time Address is an open-source, self-hosted service that turns Bitcoin wallets into webpages and embeddable widgets, displaying an address and QR code when someone wants to send Bitcoin.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

One Time Address — OpenViST project profile in Payments & Stablecoins.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when you want a self-hosted way to present Bitcoin addresses for donations or simple payment requests, without needing payment-triggered processes.

Who it is for

  • Bitcoin recipients who want a donation page with a fresh address for each request.
  • Website operators who want to embed a Bitcoin address-and-QR payment widget.

Documented uses

  • Present a Bitcoin address and QR code to someone sending a payment.
  • Share Bitcoin payment details through a webpage or an embedded widget.
  • Reduce repeated display of the same address.
Before you choose

Requirements & limits

The project is open source under the MIT license and is designed to be self-hosted.

  • The README describes a Yarn-based setup with environment and wallet configuration files.
  • The default address cache interval is five minutes; repeated requests from the same visitor during that interval may receive the cached address.
  • The project warns that many consecutive unused addresses can create wallet gap-limit discovery issues.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Set up a self-hosted Bitcoin address page

Prepare and start the service with wallet configuration.

Before you start

  • A local copy of the repository
  • Yarn to install dependencies
  • Wallet information for the wallets.js configuration

Steps

  1. Clone the repository and change into its directory.

  2. Run yarn install.

  3. Copy .env.prod to .env and wallets.js.sample to wallets.js.

  4. Set SERVER_HOST and SERVER_PORT if needed, then enter wallet information in wallets.js.

  5. Run yarn start to start the HTTP server.

Expected outcome

A running self-hosted HTTP service that can provide Bitcoin addresses through its webpages or embeddable widgets.

Guide limitations

  • The service provides an address and QR code, not e-commerce handling or processes triggered after payment.
  • A repeat request from the same visitor within the cache interval may return the previously generated address.
  • A long sequence of unused addresses may cause wallet gap-limit discovery issues.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
16 October 2026
Original website title
alexk111/One-Time-Address · Official homepage title · retained in its source language
How we review sourcesSuggest a correction

Related options

BTCPay Server — The project README suggests it for users who need features beyond providing a Bitcoin address, including e-commerce or processes triggered after payment.

Explore project →