timelock

Lock, query, and unlock time-locked BSV funds via CLTV transactions.

5|1|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/b-open-io/1sat-sdk --skill timelock
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: timelock
Source: https://github.com/b-open-io/1sat-sdk/tree/main/skills/timelock
Command: npx skills add https://github.com/b-open-io/1sat-sdk --skill timelock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers manage time-locked satoshis on the Bitcoin SV blockchain by automating lock and unlock operations and providing visibility into lock status.

Core Features & Use Cases

  • Lock BSV until a specified block height
  • Check and report lock status
  • Unlock matured locks safely with wallet integration
  • Use case: manage time-locked funds for escrow or milestone-based releases.

Quick Start

Create a lock until a target block height and check its status using the provided actions.

Frequently Asked Questions about timelock

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I lock BSV funds until a specific block height?▼

To lock BSV funds until a specific block height, you create a CLTV-based lock using the @1sat/actions module. This secures satoshis in a time-locked state until the target chain height is reached.

What is a CLTV-based lock and when do I need it for BSV transactions?▼

A CLTV-based lock restricts BSV funds from being spent until a specified blockchain height is reached. It is needed for managing time-locked funds for escrow or milestone-based releases on the Bitcoin SV network.

How do I check the lock status of time-locked BSV satoshis?▼

You check the lock status of time-locked BSV satoshis by querying the lock status through the provided actions. This reports current lock states and computes unlock eligibility based on chain height.

Do I need a wallet context to unlock matured BSV time locks?▼

Yes, unlocking matured BSV time locks requires a wallet context and access to chain height services. Wallet integration is necessary to safely produce valid signed transactions for releasing matured funds.

Can I use this Skill to manage escrow releases on the Bitcoin SV blockchain?▼

Yes, you can manage escrow releases on the Bitcoin SV blockchain by automating lock and unlock operations. It securely handles time-locked funds specifically for milestone-based releases and escrow use cases.

What happens if I try to unlock BSV before the target block height is reached?▼

You cannot unlock BSV before the target block height is reached. The Skill computes unlock eligibility by checking access to chain height services, ensuring CLTV-based locks restrict spending until the network achieves the specified block.