atlas-program-runtime 3.1.1

Atlas program runtime
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
125
126
127
128
129
130
131
132
133
134
135
136

# Atlas Program Runtime

Atlas program runtime - fully renamed from Solana to Atlas.

## Version 3.0.1 - Atlas Rebranding Release

This version contains the complete renaming of all Solana/Agave references to Atlas throughout the codebase.

### What Changed

- **Package name**: `solana-program-runtime` → `atlas-program-runtime`
- **Module names**: All `solana_*` modules renamed to `atlas_*`
- **Feature flags**: `agave-unstable-api` → `atlas-unstable-api`
- **Documentation**: All references updated to Atlas
- **Dependencies**: All `solana-*` dependencies changed to `atlas-*`

### Usage for Local Development

This package is configured to use **local path dependencies** to ensure all Atlas crates work together during the migration period.

#### Prerequisites

Ensure you have all the required Atlas crates in your workspace:

```
Atlas Chain/
├── atlas-program-runtime-3.0.0/
├── atlas-sdk-master/
│   ├── account/
│   ├── account-info/
│   ├── instruction/
│   └── ... (other SDK components)
├── atlas-sbpf/
├── atlas-svm-callback-3.0.0/
├── atlas-svm-feature-set-3.0.0/
├── atlas-transaction-context-3.0.0/
└── ... (other atlas crates)
```

#### Building

```bash
cd atlas-program-runtime-3.0.0
cargo build
```

#### Using in Your Project

Add to your `Cargo.toml`:

```toml
[dependencies]
atlas-program-runtime = { path = "../atlas-program-runtime-3.0.0" }
```

### Publishing to crates.io

**⚠️ Not Ready for Publication**

This crate is not yet ready to be published to crates.io because:

1. All atlas-* dependencies must be updated and published in the correct order
2. API compatibility must be ensured across all crates
3. The entire Atlas ecosystem should be released as a coordinated set

### Roadmap to Publication

1. **Phase 1** (Current): Local development with path dependencies
2. **Phase 2**: Create workspace configuration for all Atlas crates
3. **Phase 3**: Coordinate version numbers across ecosystem
4. **Phase 4**: Publish dependencies in topological order
5. **Phase 5**: Publish atlas-program-runtime

### Migration Guide

If you're migrating from Solana to Atlas:

#### Code Changes
```rust
// Before (Solana)
use solana_program_runtime::invoke_context::InvokeContext;

// After (Atlas)
use atlas_program_runtime::invoke_context::InvokeContext;
```

#### Cargo.toml Changes
```toml
# Before
[dependencies]
solana-program-runtime = "3.0"

# After
[dependencies]
atlas-program-runtime = { path = "../atlas-program-runtime-3.0.0" }
```

### Development

#### Running Tests
```bash
cargo test
```

#### Checking Code
```bash
cargo check
```

#### Building Documentation
```bash
cargo doc --open
```

### Contributing

When working with this crate:

1. Ensure all path dependencies point to the correct locations
2. Keep version numbers synchronized across the Atlas ecosystem
3. Test changes with the full dependency graph
4. Document any API changes

### License

Apache-2.0

### Support

For issues or questions:
- GitHub: https://github.com/anza-xyz/agave
- Homepage: https://atlas.com/

---

**Note**: This is a development version using local path dependencies. Production use should wait for the coordinated Atlas ecosystem release on crates.io.