Merge pull request #2 from ipverse/claude/remove-migration-docs-1ekP3

Remove MIGRATION.md and its references in README.md
This commit is contained in:
trick77 2026-02-26 07:55:52 +01:00 committed by GitHub
commit 61ee74a42e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 1 additions and 111 deletions

View file

@ -1,107 +0,0 @@
# Migration guide
This repository will be renamed from **asn-ip** to **as-ip-blocks**.
## Migration steps
1. If only consuming plaintext files: just update the download URL, no code changes needed
2. Update repository URLs in your code from `ipverse/asn-ip` to `ipverse/as-ip-blocks`
3. If parsing JSON: handle the `metadata` nested object and `subnets``prefixes` rename
## What's changing
### Repository name
- Old: `ipverse/asn-ip`
- New: `ipverse/as-ip-blocks`
### File structure
The file structure remains the same:
```
as/1/aggregated.json
as/1/ipv4-aggregated.txt
as/1/ipv6-aggregated.txt
```
### JSON format
**Old:**
```json
{
"asn": 1,
"handle": "LVLT-1",
"description": "Level 3 Parent LLC",
"subnets": {
"ipv4": [
"177.75.88.0/24",
"177.75.90.0/24"
],
"ipv6": []
}
}
```
**New:**
```json
{
"asn": 1,
"metadata": {
"handle": "LVLT-1",
"description": "Level 3 Parent LLC",
"countryCode": "US",
"country": "United States",
"origin": "authoritative"
},
"prefixes": {
"ipv4": [
"177.75.88.0/24",
"177.75.90.0/24"
],
"ipv6": []
}
}
```
**Changes:**
- `subnets` renamed to `prefixes`
- `handle`, `description` now nested under `metadata` object
- Added `countryCode` field in metadata (ISO 3166-1 alpha-2 code or `null`)
- Added `country` field in metadata (country name in English or `null`)
- Added `origin` field in metadata (values: `authoritative`, `inferred`, `overlaid`, `none`)
### Plaintext format
The plaintext format remains the same with separate IPv4 and IPv6 files:
ipv4-aggregated.txt:
```
# AS1 (LVLT-1)
# Level 3 Parent LLC
#
177.75.88.0/24
177.75.90.0/24
```
ipv6-aggregated.txt:
```
# AS1 (LVLT-1)
# Level 3 Parent LLC
#
2a01:1234::/32
```
### URL changes
**Old:**
```
https://raw.githubusercontent.com/ipverse/asn-ip/master/as/1/aggregated.json
https://raw.githubusercontent.com/ipverse/asn-ip/master/as/1/ipv4-aggregated.txt
https://raw.githubusercontent.com/ipverse/asn-ip/master/as/1/ipv6-aggregated.txt
```
**New:**
```
https://raw.githubusercontent.com/ipverse/as-ip-blocks/master/as/1/aggregated.json
https://raw.githubusercontent.com/ipverse/as-ip-blocks/master/as/1/ipv4-aggregated.txt
https://raw.githubusercontent.com/ipverse/as-ip-blocks/master/as/1/ipv6-aggregated.txt
```

View file

@ -1,8 +1,5 @@
# as-ip-blocks (formerly asn-ip)
> **📢 New and improved:** This repo has been upgraded with a clearer name (`as-ip-blocks`) and enhanced JSON format.
> Check out [MIGRATION.md](MIGRATION.md) for the quick changes needed (plaintext files are unchanged).
## 🔍 Try it online
Look up any AS or IP prefix at **[Lens by ipverse](https://lens.ipverse.net)** to explore announced prefixes and metadata.
@ -24,7 +21,7 @@ Git history lets you see how an AS's announcements change over time.
- **2026-01-17**: Added bulk download archive in [releases](https://github.com/ipverse/as-ip-blocks/releases/latest)
- **2026-01-08**: AS directories are now removed if no prefixes have been announced in the last 90 days. Historical metadata for removed AS may still be available in [as-metadata](https://github.com/ipverse/as-metadata).
- **2026-01-05**: Removed `lastAnnounced` field to reduce git delta size. This field is still available in [as-metadata](https://github.com/ipverse/as-metadata).
- **2026-01-03**: Repository renamed to `as-ip-blocks`, JSON format changed (`subnets``prefixes`, metadata nested). See [MIGRATION.md](MIGRATION.md) for details.
- **2026-01-03**: Repository renamed to `as-ip-blocks`, JSON format changed (`subnets``prefixes`, metadata nested).
- 2025-08-03: Removed opinionated handle cleanup
- 2023-09-03: Removed PEM certificates from description field