trpc
使用tRPC v11 API层、Zod和Ed25519认证。在处理src/server/目录下的文件时使用。
📖 中文导读:使用tRPC v11 API层、Zod和Ed25519认证。在处理src/server/目录下的文件时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: trpc description: tRPC v11 API layer with Zod and Ed25519 auth. Use when working on files in src/server/.
tRPC Guidelines
Authentication
All authenticated procedures verify Ed25519 signatures:
- Verify signature matches pubkeyHash
- Verify timestamp is recent (prevent replay)
- Verify message matches request
Patterns
Router:
export const vaultRouter = router({
create: authedProcedure
.input(createVaultSchema)
.mutation(async ({ ctx, input }) => { ... }),
});
Schema:
export const createVaultSchema = z.object({
name: z.string().min(1).max(100),
encryptedSnapshot: z.string(),
wrappedKey: z.string(),
});
Critical Rules
- Never trust client data - always validate with Zod
- Never store unencrypted data - all sensitive data comes pre-encrypted
- Verify signatures - every mutation must be signed
- Check permissions - verify user has vault access
- Use transactions - wrap multi-step operations
Error Handling
throw new TRPCError({
code: "NOT_FOUND", // or "FORBIDDEN"
message: "Vault not found",
});