How do I install the Locks skill?

Run npx skillmds@latest add b-open-io/locks in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Locks safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Locks?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Locks free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

b-open-io (@b-open-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Locks by b-open-io — Agent Skill

Name: Locks
Author: b-open-io

Locks

This skill should be used when working with time-locked BSV — locking satoshis until a specific block height, checking lock status, unlocking matured locks, or understanding the lock script. Triggers on 'lock BSV', 'time lock', 'timelock', 'block height lock', 'unlock BSV', 'matured locks', 'lock data', or 'CLTV lock'. Uses @1sat/actions locks module.

b-open-io 6cf2f26 2.0 KB Updated Sep 17, 2026

File contents

Timelock

Lock and unlock BSV until block heights with @1sat/actions.

Actions

Action	Description
`listLocks`	List lock UTXOs (metadata/tags; print `id` per row)
`getLockData`	Summary totals (total / unlockable / next height)
`lockBsv`	Lock sats until height
`unlockBsv`	Unlock by `ids?` or all matured

List locks (preferred)

import { listLocks, createContext } from '@1sat/actions'

const ctx = createContext(wallet, { services })
const { outputs } = await listLocks.execute(ctx, {})

for (const o of outputs) {
  const id = o.tags?.find((t) => t.startsWith('id:'))?.slice(3)
  const until = o.tags?.find((t) => t.startsWith('until:'))?.slice(6)
  console.log(id, o.satoshis, until)
}

Summary

import { getLockData } from '@1sat/actions'

const data = await getLockData.execute(ctx, {})
// { totalLocked, unlockable, nextUnlock }

Lock

import { lockBsv } from '@1sat/actions'

await lockBsv.execute(ctx, {
  requests: [{ satoshis: 10_000, until: 900_000 }],
})

CLI: locks bsv --sats <n> --until <height> (was locks lock --blocks).

Unlock

import { unlockBsv } from '@1sat/actions'

// all matured
await unlockBsv.execute(ctx, {})

// specific ids
await unlockBsv.execute(ctx, { ids: [id1, id2] })

Unlocked value returns to funding (not asset tag carry).

Storage

Basket lock (not locks).

Tag	Meaning
`until:{height}`	Maturity height
`id:{…}`	Tracking id

Requirements

bun add @1sat/actions @1sat/wallet @bsv/sdk

Unlock needs services for current height.

---name: locksdescription: This skill should be used when working with time-locked BSV — locking satoshis until a specific block height, checking lock status, unlocking matured locks, or understanding the lock script. Triggers on 'lock BSV', 'time lock', 'timelock', 'block height lock', 'unlock BSV', 'matured locks', 'lock data', or 'CLTV lock'. Uses @1sat/actions locks module.---# TimelockLock and unlock BSV until block heights with `@1sat/actions`.## Actions| Action | Description ||--------|-------------|| `listLocks` | List lock UTXOs (metadata/tags; print `id` per row) || `getLockData` | Summary totals (total / unlockable / next height) || `lockBsv` | Lock sats until height || `unlockBsv` | Unlock by `ids?` or all matured |## List locks (preferred)```typescriptimport { listLocks, createContext } from '@1sat/actions'const ctx = createContext(wallet, { services })const { outputs } = await listLocks.execute(ctx, {})for (const o of outputs) { const id = o.tags?.find((t) => t.startsWith('id:'))?.slice(3) const until = o.tags?.find((t) => t.startsWith('until:'))?.slice(6) console.log(id, o.satoshis, until)}```## Summary```typescriptimport { getLockData } from '@1sat/actions'const data = await getLockData.execute(ctx, {})// { totalLocked, unlockable, nextUnlock }```## Lock```typescriptimport { lockBsv } from '@1sat/actions'await lockBsv.execute(ctx, { requests: [{ satoshis: 10_000, until: 900_000 }],})```CLI: `locks bsv --sats <n> --until <height>` (was `locks lock --blocks`).## Unlock```typescriptimport { unlockBsv } from '@1sat/actions'// all maturedawait unlockBsv.execute(ctx, {})// specific idsawait unlockBsv.execute(ctx, { ids: [id1, id2] })```Unlocked value returns to funding (not asset tag carry).## StorageBasket `lock` (not `locks`).| Tag | Meaning ||-----|---------|| `until:{height}` | Maturity height || `id:{…}` | Tracking id |## Requirements```bashbun add @1sat/actions @1sat/wallet @bsv/sdk```Unlock needs `services` for current height.

Frequently asked questions