Hoe je de Arweave CLI installeert en je eerste upload doet via de terminal

Lieke de Vries

Blockchain architectuur archivering specialist

Stel je voor: je hebt een bestand dat voor altijd bewaard moet blijven. Geen angst voor serverstoringen, geen zorgen over censuur en geen maandelijkse rekeningen meer voor cloudopslag. Welkom bij Arweave.

Dit netwerk zorgt ervoor dat jouw data permanent wordt opgeslagen, verspreid over duizenden computers over de hele wereld. In dit artikel leid ik je, zonder opsmuk, naar je eerste upload via de terminal. Geen ingewikkelde theorie, maar direct aan de slag.

Waarom Arweave? Een permanente oplossing

Arweave is anders dan de cloudopslag die je kent van Google of Dropbox. Waar je bij die diensten vaak een maandelijks abonnement betaalt, betaal je bij Arweave eenmalig voor opslag.

Eenmalig betalen, en je bestand ligt daar voor altijd. Dat klinkt te mooi om waar te zijn, maar de techniek erachter is solide.

Arweave gebruikt geen traditionele blockchain, maar iets wat ze een 'blockweave' noemen. Dit is specifiek ontworpen voor het opslaan van grote hoeveelheden data. In plaats van energieverslindende rekenkracht (zoals Bitcoin), beloont Arweave nodes die schijfruimte leveren en data daadwerkelijk opslaan en uitlezen.

Dit zorgt voor een stabiel en gedecentraliseerd netwerk. Je gebruikt Arweave voor van alles: het archiveren van belangrijke documenten, het hosten van een permanente website of het vastleggen van creatieve content. Om transacties te betalen, heb je de Arweave cryptocurrency (AR) nodig. De prijs fluctueert, maar zoals altijd geldt: check de huidige koers op sites als CoinMarketCap voordat je van start gaat.

Wat heb je nodig?

Voordat we beginnen, check even of je het volgende bij de hand hebt. Je hebt het vast al, maar het is goed om zeker te weten:

• Een computer: Of je nu macOS, Linux of Windows gebruikt, het kan allemaal.
• Internet: Een stabiele verbinding om de software te downloaden en bestanden te uploaden.
• De terminal: Dit is je commandoprompt of shell. Hier voer je de opdrachten uit.
• Een Arweave wallet (aanbevolen): Hoewel je theoretisch kunt uploaden zonder wallet, is het verstandig om een wallet (zoals Temple Wallet of ArConnect) te hebben om je AR-tokens te beheren en te betalen.

De Arweave CLI installeren

De Arweave Command Line Interface (CLI) is het gereedschap dat je nodig hebt om rechtstreeks met het netwerk te praten via de terminal. De installatie verschilt per besturingssysteem.

Installatie op macOS en Linux

De makkelijkste en snelste manier op deze systemen is via Homebrew. Als je Homebrew al hebt, ben je klaar in een handomdraai.

Heb je het nog niet? Installeer het dan eerst via de officiële Homebrew-website. Zodra Homebrew actief is, open je je terminal en voer je dit commando uit:

brew install arweave

Dit commando downloadt de benodigde bestanden en installeert de CLI op je systeem. Als de installatie is voltooid, controleer je of het werkt door het volgende in te typen:

arweave version

Als het goed is, toont je terminal nu de versie van de geïnstalleerde software. Nu ben je ready to go. Voor Windows-gebruikers is de installatie net iets anders. Je downloadt de CLI rechtstreeks van de Arweave-website.

Installatie op Windows

Zoek naar de installatiepagina en download het Windows-installatiebestand (meestal een .exe-bestand). Voer het bestand uit en volg de stappen op het scherm.

De installatie kan vragen om extra tools, zoals Git, te installeren. Doe dit gewoon, want het is nodig voor een soepele werking. Nadat de installatie klaar is, open je PowerShell of de Command Prompt en typ je: Als je de versie-informatie ziet, is de installatie geslaagd.

arweave version

Je eerste upload uitvoeren

Nu het echte werk begint. We gaan een bestand uploaden naar het Arweave-netwerk.

Stap 1: Open je terminal

Laten we een simpel tekstbestand als voorbeeld nemen, maar je kunt elke soort bestand gebruiken. Open je terminal (of Command Prompt/PowerShell op Windows) en navigeer naar de map waar je bestand zich bevindt.

Stap 2: Het uploadcommando

Het basiscommando voor een upload is simpel. Type het volgende, maar vervang bestand.txt door de naam van jouw bestand: Als je bestand niet in de huidige map staat, gebruik dan het volledige pad naar het bestand. De CLI vraagt nu om je private key.

arweave upload bestand.txt

Dit is de sleutel tot je Arweave-wallet. Je kunt deze meestal kopiëren uit je wallet-extensie (zoals Temple of ArConnect) als een bestand of door de key rechtstreeks te plakken.

Stap 3: Je wallet private key

Let op: Deel je private key nooit met anderen. Het is het wachtwoord van je wallet. Arweave werkt met een eenmalige betaling.

De CLI berekent automatisch hoeveel AR-tokens nodig zijn om je bestand permanent op te slaan. De kosten hangen af van de grootte van je bestand en de huidige netwerkbelasting.

Stap 4: Betalen en bevestigen

De CLI geeft aan hoeveel AR je moet overmaken naar een specifiek adres.

Zorg dat je voldoende saldo in je wallet hebt. De kosten zijn over het algemeen laag; voor een klein bestandje ben je vaak minder dan een cent kwijt. Na de betaling begint de upload.

Stap 5: Wachten en de Transaction ID (TXID)

Dit duurt meestal maar een paar seconden, maar bij grote bestanden of een druk netwerk kan het iets langer duren. Zodra de upload is voltooid, geeft de CLI een 'Transaction ID' (TXID).

Dit is een unieke code die jouw bestand op Arweave identificeert. Bewaar deze code goed; het is het bewijs dat je data permanent is opgeslagen.

Je upload bekijken

Wil je zien of het gelukt is? Je kunt je bestand direct in een browser bekijken door je TXID te gebruiken.

Ga naar een Arweave-viewer (zoals Arweave Explore) en voer je TXID in.

Je ziet je bestand direct verschijnen, voor altijd.

Best practices en tips

Om het meeste uit Arweave te halen en problemen te voorkomen, volgen hier een paar handige tips:

• Backups van je wallet: Zorg dat je een backup maakt van je private key en deze op een veilige plek bewaart. Als je deze kwijtraakt, ben je je tokens en toegang tot je data kwijt.
• Bestandsgrootte: Grote bestanden kosten meer AR. Overweeg om grote bestanden te comprimeren voordat je ze uploadt. Dit bespaart kosten en tijd.
• Netwerkcondities: De upload-snelheid en kosten kunnen variëren. Probeer te uploaden tijdens rustige momenten als je merkt dat het traag gaat.
• Permanentiteit: Denk goed na voordat je uploadt. Arweave is permanent. Verwijderen is niet eenvoudig, dus zorg dat je zeker bent van je zaak.

Met deze stappen heb je de basis te pakken om Arweave te gebruiken via de terminal. Het is een krachtig netwerk voor wie zekerheid wil over de opslag van data. Ga aan de slag, experimenteer en publiceer je eerste statische website op het netwerk voor permanente opslag.