La Bobinerie

🧵 La Bobinerie - Haberdashery of Bobine modules: serious primitives, educational gems, and esoteric oddities. Grab, deploy, fork at will.

⸟

Le Comptoir

Available now:

Contracts

Counter Per-account counter with Ed25519 session authentication. 》open doc	Forth On-chain Forth interpreter contract for Bobine. 》open doc
Multisig Threshold-based authorization contract for Bobine call execution. 》open doc	Pool XYK XYK (constant-product) AMM pool for two fungible tokens: add/remove liquidity, swap, fee in bps. 》open doc
Say My Name A simple name storage contract that remembers who you are. 》open doc	Sigil Account-bound on-chain sigil (SVG PFP): mint one per derived address, optional on-chain tag. 》open doc
Token Fungible A minimal fungible token module for Bobine, designed to be a boring, reliable building block for DeFi modules (pools, routers, etc.). 》open doc

Agent Skills

Bobine Contract Caller Use when you need to call deployed Bobine modules with typed params or perform a signed Ed25519 call through an auth module. 》open doc

Le Manuel de l’Artisan

Project Structure

bobinerie/
├── contracts/               # All the smart contracts
│   └── say-my-name/         # A single contract
│       ├── contract.feature # BDD tests (specifications)
│       ├── out/             # Compiled outputs (WASM + types)
│       ├── README.md        # Contract documentation
│       ├── src
│       │   ├── mod.ts
│       │   └── mods
│       │       └── mod.ts
│       └── tsconfig.json
├── skills/                  # Public portable agent skills
│   └── bobine-contract-caller
│       ├── SKILL.md         # Skill definition with version in frontmatter
│       ├── references
│       └── scripts
├── run/                     # Deployment & execution scripts
└── package.json             # Build scripts

Setup

npm install

Configure your Bobine server in .env.local (optional):

SERVER=http://localhost:8080

Quick Start

Compile all contracts:

npm run prepack

Deploy a contract:

CONTRACT=say-my-name npm run contract:produce
# Returns: { address: "3ca2c27f..." }

Other common tasks:

• Build a single contract: CONTRACT=say-my-name npm run contract:build
• Produce all contracts: npm run produce
• Generate docs: npm run docs
• Run tests: npm run test
• Run tests with coverage: npm run test:coverage (measures test infrastructure, not WASM contract code)

Execute a contract method:

npm run execute 3ca2c27f... sayMyName text:"Alice"

Avis aux artisans

Got a useful contract, skill, or intriguing experiment? Put it on the shelves.

Publishing a contract

1. Create your contract in contracts/your-contract-name/
2. Write comprehensive cucumber BDD tests in contracts/your-contract-name/contract.feature
3. Add JSDoc documentation to all public API functions
4. Run npm run docs to refresh the catalog and contract docs
5. Submit a PR

Publishing a skill

1. Create your skill in skills/your-skill-name/
2. Add a portable SKILL.md with semver version in the frontmatter
3. Add scripts/ and references/ only when they materially help the agent
4. Validate the skill with skills-ref validate skills/your-skill-name
5. Run npm run docs to refresh the catalog, then submit a PR

All contributions welcome, from serious primitives to silly meme contracts and tools.