Skip to content

Point the smart wallet kits at their canonical repos and drop the legacy label #110

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kaankacar merged 1 commit into from
Aug 19, 2026
Merged

Point the smart wallet kits at their canonical repos and drop the legacy label #110

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions skills/dapp/smart-accounts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Passkey smart wallets with Smart Account Kit and gasless transactions via the Op

## Smart Accounts (Passkey Wallets)

For passwordless authentication using WebAuthn passkeys, use Smart Account Kit.
For passwordless authentication using WebAuthn passkeys, use Smart Account Kit. [Passkey Kit](https://github.com/stellar/passkey-kit) is a sibling SDK built on a different authorization model — see [Choosing between the two kits](#choosing-between-the-two-kits) before you commit to one.

### Installation
```bash
Expand Down Expand Up @@ -77,7 +77,18 @@ const response = await client.submitSorobanTransaction({
- **Production**: Self-host via Docker ([GitHub](https://github.com/OpenZeppelin/openzeppelin-relayer))
- **Stellar docs**: https://developers.stellar.org/docs/tools/openzeppelin-relayer

### Choosing between the two kits

Passkey Kit and Smart Account Kit are sibling SDKs, not successive versions. They use different on-chain authorization models, so they are **not drop-in compatible**. Pick the model that fits your app.

| Kit | Authorization model | Reach for it when |
|-----|--------------------|-------------------|
| [smart-account-kit](https://github.com/stellar/smart-account-kit) | OpenZeppelin context rules + an auth digest, on the audited [stellar-contracts](https://github.com/OpenZeppelin/stellar-contracts) account | You need context rules, thresholds, or spending-limit policies |
| [passkey-kit](https://github.com/stellar/passkey-kit) | A flat multi-signer `Signatures` map | The flat signer model covers your authorization needs |

Both are maintained. Neither README declares the other deprecated.

### Resources
- **GitHub**: https://github.com/kalepail/smart-account-kit
- **GitHub**: https://github.com/stellar/smart-account-kit
- **OpenZeppelin Contracts**: https://github.com/OpenZeppelin/stellar-contracts
- **Legacy SDK**: https://github.com/kalepail/passkey-kit (for simpler use cases)
- **Passkey Kit**: https://github.com/stellar/passkey-kit (sibling SDK — see above)
15 changes: 8 additions & 7 deletions skills/standards/ecosystem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,9 +173,10 @@ SDK for integrating multiple Stellar wallets.

### Smart Account & Authentication

#### Smart Account Kit (Recommended)
#### Smart Account Kit
Comprehensive TypeScript SDK for OpenZeppelin Smart Accounts on Stellar.
- **GitHub**: https://github.com/kalepail/smart-account-kit
- **GitHub**: https://github.com/stellar/smart-account-kit
- **Authorization model**: OpenZeppelin context rules + an auth digest
- **Use Case**: Production smart wallets with passkeys
- **Built On**: [OpenZeppelin stellar-contracts](https://github.com/OpenZeppelin/stellar-contracts)
- **Features**:
Expand All @@ -186,11 +187,11 @@ Comprehensive TypeScript SDK for OpenZeppelin Smart Accounts on Stellar.
- Built-in indexer for contract discovery
- Multiple signer types (passkeys, Ed25519, policies)

#### Passkey Kit (Legacy)
Original TypeScript SDK for passkey-based smart wallets.
- **GitHub**: https://github.com/kalepail/passkey-kit
- **Status**: Legacy - use Smart Account Kit for new projects
- **Use Case**: Simple passkey wallet integration
#### Passkey Kit
TypeScript SDK for passkey-based smart wallets. Sibling to Smart Account Kit, with a different authorization model — the two are not drop-in compatible.
- **GitHub**: https://github.com/stellar/passkey-kit
- **Authorization model**: A flat multi-signer `Signatures` map
- **Use Case**: Passkey wallet integration where the flat signer model is enough
- **Integration**: OpenZeppelin Relayer (gasless tx), Mercury (indexing)
- **Demo**: [passkey-kit-demo.pages.dev](https://passkey-kit-demo.pages.dev)
- **Example**: [Super Peach](https://github.com/kalepail/superpeach)
Expand Down
4 changes: 2 additions & 2 deletions skills/standards/resources.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,8 @@ Curated documentation, SDK, tooling, and learning links. Companion to [SKILL.md]
- [Contract Wizard](https://wizard.openzeppelin.com/stellar) - Generate contracts

### Smart Account SDKs
- [Smart Account Kit](https://github.com/kalepail/smart-account-kit) - Production smart wallet SDK (recommended)
- [Passkey Kit](https://github.com/kalepail/passkey-kit) - Legacy passkey wallet SDK
- [Smart Account Kit](https://github.com/stellar/smart-account-kit) - Smart wallet SDK using OpenZeppelin context rules + auth digest
- [Passkey Kit](https://github.com/stellar/passkey-kit) - Sibling smart wallet SDK using a flat multi-signer `Signatures` map
- [Super Peach](https://github.com/kalepail/superpeach) - Smart wallet implementation example

### Developer Tools
Expand Down
Loading