Repository files navigation

For security, Square stores a reserve of Bitcoins in an offline setting. By having these funds offline, wereduce attack surface and risk of theft.

Square's solution is unique, specifically, we leverage FIPS certified Hardware Security Modules (HSMs) to protect theprivate key material. We decided to use such HSMs because we already own, operate, and trust these devices for other payment-related needs.

Funds can be sent from online systems to the cold storage at any time. Moving funds out of cold storage requires amulti-party signing ceremony. In addition, the offline HSMs are able to enforce business logic rules, for instance weonly allow sending funds to Square-owned addresses. Such a scheme is usually called defense in depth or an onion model.We maintain the online/offline isolation by importing transaction metadata and exporting signatures using QR codes.

HSMs have the ability to share key material. This enables the ability to store our backups in encrypted form andrestore a wallet at any location.

This repo contains our design documents as well as specific technical information. We are sharing our source code, withthe caveat that the code is currently only useful if you have the exact same hardware setup. We are willing to make thecode more modular over time, as long as the broader community shows interest to implement support for additionalhardware vendors.

See alsoOpen Sourcing Subzero (blog post)

https://subzero.readthedocs.io

Copyright 2018 Square, Inc.Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License at   http://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.