Skip to content

Commit b0dbb78

Browse files
JosueBrenesaguilar1xwmendesNicobustelo
authored
develop to main (#8)
* chore: remove project files including .gitignore, package.json, README.md, and husky hooks * chore: add package-lock.json to manage frontend dependencies and ensure consistent installations * chore: add husky for pre-commit and pre-push hooks, update package.json and package-lock.json * chore: update @acta-team/acta-sdk dependency to version 1.1.7 in package.json and package-lock.json * chore: update @acta-team/acta-sdk dependency to version 1.1.8 in package.json and package-lock.json * refactor: new idea to interactuar * chore: change imports * feat: add acta skill * docs: add root readme * README BRAND SYSTEM añadido * chore: add .temp and .branches folder * chore: move supabase dependencies to devDependencies * docs: add brand system and design guidelines document --------- Co-authored-by: aguilar1x <aaguilar1x@gmail.com> Co-authored-by: Wlad Mendes <wlademyr.mendes@gmail.com> Co-authored-by: Nicobustelo <nbustelo2002@gmail.com>
1 parent bbb1b22 commit b0dbb78

74 files changed

Lines changed: 13442 additions & 8311 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.agent/skills/acta‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
../../.agents/skills/acta

‎.agents/skills/acta/.gitignore‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Environment files - NEVER commit API keys!
2+
.env
3+
.env.local
4+
.env.*.local
5+
.env.development.local
6+
.env.test.local
7+
.env.production.local
8+
9+
# Dependencies
10+
node_modules/
11+
.pnpm-store/
12+
13+
# Build outputs
14+
dist/
15+
build/
16+
.next/
17+
out/
18+
19+
# Logs
20+
*.log
21+
npm-debug.log*
22+
yarn-debug.log*
23+
yarn-error.log*
24+
pnpm-debug.log*
25+
26+
# OS files
27+
.DS_Store
28+
Thumbs.db
29+
30+
# IDE files
31+
.vscode/
32+
.idea/
33+
*.swp
34+
*.swo
35+
*~
36+
37+
# Test coverage
38+
coverage/
39+
.nyc_output/
40+
41+
# Temporary files
42+
tmp/
43+
temp/
44+
*.tmp
45+
46+
# Credentials and secrets (extra safety)
47+
*secret*
48+
*credential*.json
49+
*private*
50+
*.pem
51+
*.key

‎.agents/skills/acta/LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2024 acta-skill
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎.agents/skills/acta/QUICKSTART.md‎

Lines changed: 213 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,213 @@
1+
# Quick Start Guide
2+
3+
Get started with the acta.build verifiable credentials skill in 5 minutes.
4+
5+
## 1. Install the Skill
6+
7+
```bash
8+
# From the skill directory
9+
npx skills add .
10+
11+
# Or from GitHub (when published)
12+
npx skills add wlademyr/acta-skill
13+
```
14+
15+
## 2. Test Helper Scripts
16+
17+
Verify your API connection:
18+
19+
```bash
20+
npm run test:api
21+
```
22+
23+
Validate credential templates:
24+
25+
```bash
26+
npm run validate:education
27+
npm run validate:employment
28+
npm run validate:identity
29+
```
30+
31+
## 3. Invoke the Skill
32+
33+
In Claude Code:
34+
35+
```
36+
$acta help me set up my first credential vault
37+
```
38+
39+
Or implicitly:
40+
41+
```
42+
I want to issue a verifiable credential for education
43+
```
44+
45+
## 4. Common Tasks
46+
47+
### Issue a Credential
48+
49+
```
50+
$acta help me issue an education credential
51+
```
52+
53+
The skill will:
54+
- Check your setup (API key, wallet)
55+
- Show you the credential template
56+
- Guide you through the issuance process
57+
- Provide safety confirmations
58+
59+
### Verify a Credential
60+
61+
```
62+
$acta verify this credential: vc:education:degree:12345
63+
```
64+
65+
The skill will:
66+
- Read the credential from the vault
67+
- Check validity and issuer authorization
68+
- Display credential details
69+
70+
### Set Up a Vault
71+
72+
```
73+
$acta create a vault for my wallet
74+
```
75+
76+
The skill will:
77+
- Connect to Freighter wallet
78+
- Create vault with your DID
79+
- Confirm successful creation
80+
81+
## 5. Prerequisites Checklist
82+
83+
Before using the skill, ensure you have:
84+
85+
- [ ] **API Key** from https://dapp.acta.build
86+
- [ ] **Freighter Wallet** installed and configured for testnet
87+
- [ ] **API Key in .env.local**:
88+
```
89+
ACTA_API_KEY_TESTNET=your_api_key_here
90+
```
91+
- [ ] **.env.local in .gitignore** (protect your API key!)
92+
- [ ] **Testnet XLM** funded wallet (free from Stellar Laboratory)
93+
94+
## 6. File Structure
95+
96+
```
97+
acta-skill/
98+
├── SKILL.md # Main skill definition (read first!)
99+
├── README.md # Installation guide
100+
├── QUICKSTART.md # This file
101+
├── references/ # Detailed documentation
102+
│ ├── platform-overview.md
103+
│ ├── react-sdk-reference.md
104+
│ ├── credential-lifecycle.md
105+
│ ├── vault-management.md
106+
│ └── security-best-practices.md
107+
├── assets/
108+
│ ├── credential-templates/ # JSON templates
109+
│ └── examples/ # React components
110+
└── scripts/ # Helper utilities
111+
├── test-api-connection.js
112+
└── validate-credential.js
113+
```
114+
115+
## 7. Safety First
116+
117+
The skill follows these safety principles:
118+
119+
⚠️ **Mandatory Confirmations**
120+
- All credential operations require explicit approval
121+
- Vault creation requires confirmation
122+
- Issuer revocation requires typing "REVOKE"
123+
124+
🔐 **Security Best Practices**
125+
- API keys never in code
126+
- Private keys stay in wallet
127+
- Testnet default for development
128+
129+
🛡️ **Immutability Warnings**
130+
- Credentials cannot be deleted
131+
- Users must understand permanence
132+
- Clear consequences explained
133+
134+
## 8. Example Workflows
135+
136+
### Complete Setup (First Time)
137+
138+
```
139+
$acta I'm new to verifiable credentials, help me get started
140+
```
141+
142+
1. Skill checks prerequisites
143+
2. Guides you to obtain API key
144+
3. Helps configure environment
145+
4. Creates vault
146+
5. Issues first credential
147+
148+
### Issue Employment Credential
149+
150+
```
151+
$acta issue an employment verification credential
152+
```
153+
154+
1. Skill loads employment template
155+
2. Prompts for job details
156+
3. Shows confirmation dialog
157+
4. Signs with Freighter
158+
5. Returns credential ID
159+
160+
### Verify Someone's Credential
161+
162+
```
163+
$acta verify credential vc:education:degree:xyz from wallet GXXXXX
164+
```
165+
166+
1. Skill queries vault
167+
2. Checks issuer authorization
168+
3. Validates signatures
169+
4. Displays credential data
170+
171+
## 9. Troubleshooting
172+
173+
**"API key not found"**
174+
- Create `.env.local` file
175+
- Add `ACTA_API_KEY_TESTNET=your_key`
176+
- Restart your application
177+
178+
**"Vault not found"**
179+
- Create vault first with `$acta create vault`
180+
- Check you're using correct wallet address
181+
182+
**"Issuer not authorized"**
183+
- Authorize issuer with `$acta authorize issuer GXXXXX`
184+
- Confirm authorization completed
185+
186+
**"Insufficient balance"**
187+
- Fund testnet wallet: https://laboratory.stellar.org/#account-creator?network=test
188+
- Mainnet: Add real XLM
189+
190+
## 10. Next Steps
191+
192+
- Read `SKILL.md` for complete workflow
193+
- Explore `references/` for detailed documentation
194+
- Try example React components in `assets/examples/`
195+
- Join Discord: https://discord.gg/DsUSE3aMDZ
196+
197+
## Resources
198+
199+
- **Website:** https://acta.build
200+
- **Documentation:** https://docs.acta.build
201+
- **dApp:** https://dapp.acta.build
202+
- **GitHub:** https://github.com/ACTA-Team
203+
- **Discord:** https://discord.gg/DsUSE3aMDZ
204+
205+
---
206+
207+
**Need help?** Ask in the skill:
208+
209+
```
210+
$acta I'm stuck with [your issue]
211+
```
212+
213+
The skill will guide you through troubleshooting!

‎.agents/skills/acta/README.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# acta.build Verifiable Credentials Skill
2+
3+
Guide developers through integrating acta.build's W3C Verifiable Credentials 2.0 infrastructure on Stellar blockchain.
4+
5+
## Installation
6+
7+
Install this skill using the Claude Code CLI:
8+
9+
```bash
10+
npx skills add wlademyr/acta-skill
11+
```
12+
13+
Or clone and use locally:
14+
15+
```bash
16+
git clone https://github.com/wlademyr/acta-skill
17+
cd acta-skill
18+
npx skills add .
19+
```
20+
21+
## Usage
22+
23+
Invoke the skill with:
24+
25+
```
26+
$acta help me issue a credential
27+
$acta verify this credential
28+
$acta set up a vault
29+
```
30+
31+
Or implicitly by mentioning verifiable credentials or acta.build in your query.
32+
33+
## Prerequisites
34+
35+
- Node.js 18+
36+
- React 16.8+ (for React SDK integration)
37+
- Freighter wallet (for testnet operations)
38+
- API key from https://dapp.acta.build
39+
40+
## Features
41+
42+
- ✅ **Credential Issuance** - Issue W3C VC 2.0 credentials on Stellar
43+
- ✅ **Credential Verification** - Verify credential authenticity and validity
44+
- 🔐 **Vault Management** - Create and manage encrypted credential vaults
45+
- 🛡️ **Security Guardrails** - Mandatory confirmations and best practices
46+
- 📝 **Code Examples** - Working React SDK integration examples
47+
- 🧪 **Helper Scripts** - API testing and credential validation tools
48+
49+
## Documentation
50+
51+
See `SKILL.md` for the complete workflow and safety rules.
52+
53+
Reference documentation in `references/`:
54+
- `platform-overview.md` - acta.build architecture
55+
- `react-sdk-reference.md` - Complete SDK documentation
56+
- `credential-lifecycle.md` - Issue, verify, revoke workflows
57+
- `vault-management.md` - Vault setup and operations
58+
- `security-best-practices.md` - Key management and safety
59+
60+
## License
61+
62+
MIT License - see LICENSE file for details.
63+
64+
## Links
65+
66+
- acta.build: https://acta.build
67+
- Documentation: https://docs.acta.build
68+
- Live dApp: https://dapp.acta.build
69+
- GitHub: https://github.com/ACTA-Team
70+
- Discord: https://discord.gg/DsUSE3aMDZ

0 commit comments

Comments
 (0)