memento-server

An experimental Memento (RFC 7089) server.

Install

yarn

Configure

Edit the .env to set the absolute path of the Menento git repository : MEMENTO_REPOSITORY.

Demo

Initialize the repository:

yarn init-repository

Start the server:

yarn server

Post a demonstraton Event Notifications Offer containing an event log link:

yarn demo-post

Process the LDN inbox of this server:

yarn handle-inbox

Optionally send Event Notification in the outbox to the target:

yarn handle-outbox

Consult the Memento TimeMap for the demo event log:

curl http://localhost:8000/map/http://localhost:8000/demo/paper01/eventlog.jsonld

Retrieve a memento for the demo event log (this URL might be different on your system):

curl http://localhost:8000/memento/20240408104031/http://localhost:8000/demo/paper01/eventlog.jsonld

Command line

# Start server
./bin/memento-server.js start-server

# Process inbox
./bin/memento-server.js handler @inbox

# Process outbox
./bin/memento-server.js handler @outbox

# Intialize the memento repository
./bin/memento-server.js init-repository

# List the contents of the repository
./bin/memento-server.js list-repository

# List the mementos for a URL
./bin/memento-server.js mementos <URL>

# List the memento for a URL on a datetime
./bin/memento-server.js memento <URL> <datetime>

Daemonize

Install pm2:

yarn global all pm2

Start the server in daemon mode:

pm2 start "./bin/memento-server start-server"

Start the inbox and outbox handlers in daemin mode

pm2 start "./bin/memento-server handler --loop 30 @inbox"
pm2 start "./bin/memento-server handler --loop 30 @outbox"

Monitor all services

pm2 monit

Wayback support

See https://docs.google.com/document/d/1Nsv52MvSjbLb2PCpHlat0gkzw0EvtSgpKHu4mk0MnrA/edit Need S3 API keys requestable at https://archive.org/account/s3.php

See also

• https://github.com/MellonScholarlyCommunication/ldn-inbox-server