Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs/node: Switch Archive Snapshots to new Multipart ones #523

Merged
merged 5 commits into from
Dec 23, 2024
Merged

docs/node: Switch Archive Snapshots to new Multipart ones #523

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
12187e9
Switch Archive Snapshots to new Multipart ones
Dec 20, 2024
ab053a8
improve instructions
Dec 20, 2024
978b1b8
fix prettier
Dec 20, 2024
7c75539
fix import order
Dec 20, 2024
3072829
fix typo
Dec 23, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 68 additions & 9 deletions src/components/Docs/components/NodeSnapshots.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,10 @@ import axios from "axios";
import { format } from "date-fns";
import React, { useEffect, useMemo, useState } from "react";

import { LoadingTable, NetworkTypeTabs, networkTypeTabs } from "~/components/shared";
import { LoadingTable, NetworkTypeTabs, networkTypeTabs, IconLink } from "~/components/shared";

import { CopyToClipboard } from "../../shared/components/CodeBlock/components/CopyToClipboard";


interface NodeSnapshotsProps {
apiUrl: string;
Expand All @@ -13,23 +16,27 @@ interface Snapshot {
type: string;
networkVersion?: string;
height?: number;
size?: number;
creationDate?: string;
link?: string;
links?: string[];
instructions?: string;
}

const NodeSnapshots: React.FC<NodeSnapshotsProps> = ({ apiUrl }) => {
const [mainnetSnapshots, setMainnetSnapshots] = useState<Snapshot[]>([]);
const [testnetSnapshots, setTestnetSnapshots] = useState<Snapshot[]>([]);
const [isLoading, setIsLoading] = useState(true);
const [activeTab, setActiveTab] = useState(networkTypeTabs[0]);
const [dropdownOpen, setDropdownOpen] = useState<number | null>(null);

useEffect(() => {
const fetchData = async () => {
const endpoints = [
`${apiUrl}/testnet/fullnode/latest.json`,
`${apiUrl}/testnet/archive/latest.json`,
`${apiUrl}/testnet/archive-multipart/latest.json`,
`${apiUrl}/mainnet/fullnode/latest.json`,
`${apiUrl}/mainnet/archive/latest.json`,
`${apiUrl}/mainnet/archive-multipart/latest.json`,
];

const fetchEndpoint = async (endpoint: string) => {
Expand Down Expand Up @@ -82,7 +89,7 @@ const NodeSnapshots: React.FC<NodeSnapshotsProps> = ({ apiUrl }) => {
if (Number.isNaN(date.getTime())) {
return "Invalid date";
}
return format(date, "PPPpp");
return format(date, "PPP");
};

const snapshots = useMemo(() => {
Expand All @@ -104,7 +111,9 @@ const NodeSnapshots: React.FC<NodeSnapshotsProps> = ({ apiUrl }) => {
<th>Network Version</th>
<th>Height</th>
<th>Creation Date</th>
<th>Size</th>
<th>Download</th>
<th>API</th>
</tr>
</thead>
<tbody>
Expand All @@ -114,12 +123,62 @@ const NodeSnapshots: React.FC<NodeSnapshotsProps> = ({ apiUrl }) => {
<td>{snapshot.networkVersion || ""}</td>
<td>{snapshot.height || ""}</td>
<td>{formatDate(snapshot.creationDate)}</td>

<td>
{
snapshot.size
? snapshot.size >= 1024 ** 4
? (snapshot.size / (1024 ** 4)).toFixed(1) + "TB"
: (snapshot.size / (1024 ** 3)).toFixed(1) + "GB"
: ""
}
</td>
<td>
{snapshot.link ? (
<a href={snapshot.link} target="_blank" rel="noopener noreferrer">
<button>Download</button>
</a>
) : snapshot.links ? (
<div>
<button
onClick={() => setDropdownOpen(dropdownOpen === index ? null : index)}
className="hover:text-[rgb(176,255,97,0.8)]"
>
{dropdownOpen === index ? "Hide Parts" : "Show Parts"}
</button>
{dropdownOpen === index && (
<div className="mt-2">
<ul>
{snapshot.links.map((link: string, linkIndex: number) => (
<li key={linkIndex} className="mt-1">
<a href={link} target="_blank" rel="noopener noreferrer">
Part {linkIndex + 1}
</a>
</li>
))}
</ul>
<div className="mt-2 flex items-center gap-4">
<p>Script</p>
<CopyToClipboard
getValue={() =>
snapshot.instructions || "No instructions available"
}
/>
</div>
</div>
)}
</div>
) : null}
</td>
<td>
{snapshot.link ? (
<a href={snapshot.link} target="_blank" rel="noopener noreferrer">
<button>Download</button>
</a>
) : null}
<a
href={`https://snapshots.rpc.zetachain.com/${snapshot.environment}/${snapshot.type}/latest.json`}
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 text-blue-500 hover:text-blue-600"
>
<IconLink className="text-grey-300 dark:text-grey-400 icon-link transition-all" />
</a>
julianrubino marked this conversation as resolved.
Show resolved Hide resolved
</td>
</tr>
))}
Expand Down
10 changes: 9 additions & 1 deletion src/pages/nodes/start-here/syncing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,15 @@ inside `~/.zetacored` directory.
<NodeSnapshots apiUrl="https://snapshots.rpc.zetachain.com" />

<Alert variant="warning">
Note: Our nodes database backend is `pebbledb`. Ensure that your node is configured to
Our **archive snapshots** are now available in a **multipart** format.
You can download each part individually by clicking **"Show Parts"** and selecting the desired one.
Alternatively, you can streamline the process by copying the provided **POSIX download script**.
This script automates **downloading, packing, and extracting** the full snapshot. Simply click the **"Copy to Clipboard"**
icon below the parts list to copy the one-liner command and run it on a terminal.
</Alert>

<Alert variant="warning">
Snaphhots database backend is **pebbledb**. Ensure that your node is configured to
use the same backend to utilize our snapshots.
</Alert>

Expand Down
Loading