pda-counter 0.1.1

A minimal Solana smart contract using Anchor to demonstrate PDA-based counter logic.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

# PDA Counter — Solana Anchor Project

Version: 0.1.0  
License: MIT

[![Crates.io](https://img.shields.io/crates/v/pda-counter.svg)](https://crates.io/crates/pda-counter)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

This project is a minimal smart contract on the Solana blockchain, built using the Anchor framework. It allows users to create and manage their own on-chain counter using a Program Derived Address (PDA). Each counter is tied to a specific user and supports incrementing, resetting, and automatic closure.

---

## Features

- Create a PDA counter account tied to a user's wallet
- Increment the counter securely with access control
- Reset and close the account to reclaim rent
- Events emitted for each operation (initialize, increment, reset)
- Anchor-based Rust smart contract with JavaScript test suite

---

## Stack

- Solana (devnet)
- Rust (Anchor framework)
- JavaScript (Mocha + Anchor testing utilities)

---

## How to Run

1. Install dependencies:

   yarn install

2. Build the program:

   anchor build

3. Deploy to devnet (optional):

   anchor deploy

   Make sure your wallet is funded:

   solana airdrop 2

4. Run the test suite:

   anchor test

   This will:
   - Derive a PDA for your wallet
   - Initialize the counter
   - Increment it
   - Reset and close the account
   - Confirm the account is closed

## Example Test Output

Below is a screenshot of the successful test run using `anchor test`:

![Anchor test result](anchor_test_result.png)
---

## Folder Structure

pda_counter  
├── programs/  
│   └── pda_counter/        Rust smart contract  
│       └── src/lib.rs  
├── tests/  
│   └── pda_counter.js      JavaScript test suite  
├── Anchor.toml             Anchor config  
├── Cargo.toml              Workspace config  
├── package.json            JS dependencies and scripts  
├── LICENSE                 MIT license  
└── README.md               This file  

---

## Smart Contract Logic

- `initialize`: Creates a new counter PDA with the caller as the owner.
- `increment`: Increases the counter by one. Only the owner can call this.
- `reset`: Resets the counter and closes the account, returning rent to the user.
- Each function emits an event for tracking on-chain state changes.

---

## PDA Details

Each user’s counter is stored at a deterministic PDA derived using:

Seed: "counte"  
Key: [ "counte", user public key ]  
Bump: Automatically computed by Anchor

Note: The seed "counte" (not "counter") was used to avoid PDA conflicts during testing.

---

## License

This project is licensed under the MIT License. See the LICENSE file for details.

---

## Summary

This is a clean example of a complete Solana program using Anchor. It demonstrates:
- PDA account creation and access control
- Basic instruction handling
- Event emission
- JavaScript-based testing with Anchor

The project can serve as a learning reference or a base for more advanced Solana applications.

---

## Author

Maintained by [Adarsh](https://github.com/Webrowse)