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.