| 1 | package Net::Nostr::HttpAuth; | ||
| 2 | |||
| 3 | 2 | ▶ | use strictures 2; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 4 | |||
| 5 | 2 | ▶ | use Net::Nostr::_ConstructorArgs (); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 6 | |||
| 7 | 2 | ▶ | use Carp qw(croak); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 8 | 2 | ▶ | use JSON (); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 9 | 2 | ▶ | use MIME::Base64 qw(encode_base64 decode_base64); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 10 | 2 | ▶ | use Digest::SHA qw(sha256_hex); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 11 | 0 | ▶ | use Net::Nostr::Event; |
|
Subroutine
BEGIN: called CC=1 SCAR=2.6
| |||
| 12 | use Exporter 'import'; | ||
| 13 | |||
| 14 | our @EXPORT_OK = qw( | ||
| 15 | create_auth_event | ||
| 16 | create_auth_header | ||
| 17 | parse_auth_header | ||
| 18 | validate_auth_event | ||
| 19 | ); | ||
| 20 | |||
| 21 | my $HEX64 = qr/\A[0-9a-f]{64}\z/; | ||
| 22 | |||
| 23 | sub create_auth_event { | ||
| 24 | my %args = Net::Nostr::_ConstructorArgs::normalize(@_); | ||
| 25 | my $pubkey = $args{pubkey} // croak "pubkey is required"; | ||
| 26 | my $url = $args{url} // croak "url is required"; | ||
| 27 | my $method = $args{method} // croak "method is required"; | ||
| 28 | |||
| 29 | croak "pubkey must be 64-char lowercase hex" unless $pubkey =~ $HEX64; | ||
| 30 | |||
| 31 | my @tags = ( | ||
| 32 | ['u', $url], | ||
| 33 | ['method', $method], | ||
| 34 | ); | ||
| 35 | |||
| 36 | # SHOULD include payload hash for body-bearing methods | ||
| 37 | if (defined $args{payload}) { | ||
| 38 | push @tags, ['payload', sha256_hex($args{payload})]; | ||
| 39 | } | ||
| 40 | |||
| 41 | return Net::Nostr::Event->new( | ||
| 42 | pubkey => $pubkey, | ||
| 43 | kind => 27235, | ||
| 44 | content => '', | ||
| 45 | tags => \@tags, | ||
| 46 | created_at => $args{created_at} // time(), | ||
| 47 | ); | ||
| 48 | } | ||
| 49 | |||
| 50 | sub create_auth_header { | ||
| 51 | my %args = Net::Nostr::_ConstructorArgs::normalize(@_); | ||
| 52 | my $key = $args{key} // croak "key is required"; | ||
| 53 | my $url = $args{url} // croak "url is required"; | ||
| 54 | my $method = $args{method} // croak "method is required"; | ||
| 55 | |||
| 56 | my $event = create_auth_event( | ||
| 57 | pubkey => $key->pubkey_hex, | ||
| 58 | url => $url, | ||
| 59 | method => $method, | ||
| 60 | (defined $args{payload} ? (payload => $args{payload}) : ()), | ||
| 61 | (defined $args{created_at} ? (created_at => $args{created_at}) : ()), | ||
| 62 | ); | ||
| 63 | |||
| 64 | $key->sign_event($event); | ||
| 65 | |||
| 66 | my $json = JSON->new->utf8->encode($event->to_hash); | ||
| 67 | my $b64 = encode_base64($json, ''); | ||
| 68 | return "Nostr $b64"; | ||
| 69 | } | ||
| 70 | |||
| 71 | sub parse_auth_header { | ||
| 72 | my ($header) = @_; | ||
| 73 | croak "authorization header is required" unless defined $header && length $header; | ||
| 74 | |||
| 75 | my ($scheme, $b64) = split / /, $header, 2; | ||
| 76 | croak "expected Nostr authorization scheme, got $scheme" | ||
| 77 | unless defined $scheme && $scheme eq 'Nostr'; | ||
| 78 | croak "missing base64 data" unless defined $b64 && length $b64; | ||
| 79 | |||
| 80 | my $json = decode_base64($b64); | ||
| 81 | croak "invalid base64 data" unless defined $json && length $json; | ||
| 82 | |||
| 83 | my $data = eval { JSON->new->utf8->decode($json) }; | ||
| 84 | croak "invalid JSON in authorization header: $@" if $@; | ||
| 85 | |||
| 86 | return Net::Nostr::Event->from_wire($data); | ||
| 87 | } | ||
| 88 | |||
| 89 | sub validate_auth_event { | ||
| 90 | my ($event, %opts) = @_; | ||
| 91 | croak "event is required" unless defined $event; | ||
| 92 | my $url = $opts{url} // croak "url is required"; | ||
| 93 | my $method = $opts{method} // croak "method is required"; | ||
| 94 | my $time_window = $opts{time_window} // 60; | ||
| 95 | |||
| 96 | # 0. Verify event ID and signature (NIP-01 requirement) | ||
| 97 | $event->validate; | ||
| 98 | |||
| 99 | # 1. Kind MUST be 27235 | ||
| 100 | croak "kind must be 27235" unless $event->kind == 27235; | ||
| 101 | |||
| 102 | # 2. created_at MUST be within time window | ||
| 103 | my $age = abs(time() - $event->created_at); | ||
| 104 | croak "created_at outside time window ($age > $time_window seconds)" | ||
| 105 | if $age > $time_window; | ||
| 106 | |||
| 107 | # 3. u tag MUST match exactly | ||
| 108 | my $u_value; | ||
| 109 | my $method_value; | ||
| 110 | my $payload_value; | ||
| 111 | for my $tag (@{$event->tags}) { | ||
| 112 | if ($tag->[0] eq 'u' && !defined $u_value) { | ||
| 113 | $u_value = $tag->[1]; | ||
| 114 | } elsif ($tag->[0] eq 'method' && !defined $method_value) { | ||
| 115 | $method_value = $tag->[1]; | ||
| 116 | } elsif ($tag->[0] eq 'payload' && !defined $payload_value) { | ||
| 117 | $payload_value = $tag->[1]; | ||
| 118 | } | ||
| 119 | } | ||
| 120 | |||
| 121 | croak "missing u tag" unless defined $u_value; | ||
| 122 | croak "u tag does not match request URL" | ||
| 123 | unless $u_value eq $url; | ||
| 124 | |||
| 125 | # 4. method tag MUST match | ||
| 126 | croak "missing method tag" unless defined $method_value; | ||
| 127 | croak "method tag does not match request method" | ||
| 128 | unless $method_value eq $method; | ||
| 129 | |||
| 130 | # MAY: check payload hash if server provides the body | ||
| 131 | if (defined $payload_value && defined $opts{payload}) { | ||
| 132 | my $expected = sha256_hex($opts{payload}); | ||
| 133 | croak "payload tag does not match request body hash" | ||
| 134 | unless $payload_value eq $expected; | ||
| 135 | } | ||
| 136 | |||
| 137 | return 1; | ||
| 138 | } | ||
| 139 | |||
| 140 | 1; | ||
| 141 | |||
| 142 | __END__ | ||