Skip to content

docs: Add skills for OISY Wallet Signer#16

Draft
AntonioVentilii wants to merge 11 commits intomainfrom
docs/Add-skills-for-OISY-Wallet-Signer
Draft

docs: Add skills for OISY Wallet Signer#16
AntonioVentilii wants to merge 11 commits intomainfrom
docs/Add-skills-for-OISY-Wallet-Signer

Conversation

@AntonioVentilii
Copy link
Collaborator

@AntonioVentilii AntonioVentilii commented Feb 26, 2026

Adding the SKILL.md file for the repo OISY Wallet Signer.

Credits: @artkorotkikh-dfinity

---
id: oisy-wallet-signer
name: OISY Wallet Signer
category: Wallet
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe there is a predefined list of categories?

Comment on lines 16 to 37
## What This Is

A TypeScript library that enables secure communication between dApps and wallets on the Internet Computer using JSON-RPC 2.0 over `window.postMessage`. The signer model = **explicit per-action approval**. `connect()` establishes a channel. Nothing more.

**It is not:**

- A session system
- A delegated identity (no ICRC-34)
- A background executor

**ICRC standards implemented:**

- ICRC-21 — Canister call consent messages
- ICRC-25 — Signer interaction standard (permissions)
- ICRC-27 — Accounts
- ICRC-29 — Window PostMessage transport
- ICRC-49 — Call canister

**Not yet implemented:**

- ICRC-46 — Session-based delegation (not supported; use a delegation-capable model if you need sessions)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

too long? the guidelines say 2-3 sentences...

});
```

#### IcrcWallet — Any ICRC Ledger
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe here not ANY ICRC ledger but "SUPPORTED ICRC as explained before"

| Denied | `ICRC25_PERMISSION_DENIED` | Rejected immediately (error 3000) |
| Ask on use | `ICRC25_PERMISSION_ASK_ON_USE` | Prompts user on access (default) |

Permissions stored in `localStorage` as `oisy_signer_{origin}_{owner}` with timestamps. Default validity: 7 days.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is the validity correct? shall we specify if customizable or not?

name: OISY Wallet Signer
category: Wallet
description: Guides integration with @dfinity/oisy-wallet-signer for building dApps (relying party) and wallet UIs (signer) on the Internet Computer using ICRC-21/25/27/29/49 standards. Load when the user mentions wallet signer, relying party, consent messages, token transfers via signer, or canister call signing.
version: 4.1.0
Copy link
Collaborator Author

@AntonioVentilii AntonioVentilii Feb 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we need the app version or the "skill" version?

version: 4.1.0
endpoints: 5
status: stable
dependencies: ["@dfinity/utils", "@dfinity/zod-schemas", "@icp-sdk/canisters", "@icp-sdk/core", "zod"]
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here maybe we are talking about skills dependencies?


# OISY Wallet Signer

> version: 4.1.0 | requires: [@dfinity/utils >= 4.1, @dfinity/zod-schemas >= 3, @icp-sdk/canisters >= 3.2, @icp-sdk/core >= 5, zod >= 4]
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we need the app version or the "skill" version? and maybe we are talking about skills dependencies?

Copy link
Collaborator

@JoshDFN JoshDFN left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good — solid skill file. Note: the dependencies field lists npm packages but should list skill IDs (other skills in this repo). The npm deps belong in a requires frontmatter field instead. Also category: Wallet isn't in the current category list — may need to pick an existing one or we add it. Minor stuff, happy to merge once you take it out of draft.

@JoshDFN
Copy link
Collaborator

JoshDFN commented Feb 26, 2026

Hey Antonio — approved! One small thing: the dependencies field in frontmatter is for referencing other skill IDs in this repo (e.g., [icrc-ledger, wallet]), not npm packages. Your npm deps should go in a requires field instead:

dependencies: []
requires: [@dfinity/utils >= 4.1, @dfinity/zod-schemas >= 3, @icp-sdk/canisters >= 3.2, @icp-sdk/core >= 5, zod >= 4]

Ready to merge once you fix that and take it out of draft!

@JoshDFN JoshDFN mentioned this pull request Feb 26, 2026
Copy link

@sbpublic sbpublic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

so, here my review, part I

- ICRC-29 — Window PostMessage transport
- ICRC-49 — Call canister

**Not yet implemented:**

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no "yet". only "Not implemented"

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants