| 1 | package Net::Nostr::Blossom; | ||
| 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 Digest::SHA qw(sha256_hex); |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 9 | 0 | ▶ | use Net::Nostr::Event; |
|
Subroutine
BEGIN: called CC=1 SCAR=2.6
| |||
| 10 | use Scalar::Util qw(blessed); | ||
| 11 | use URI (); | ||
| 12 | |||
| 13 | use Class::Tiny qw(_servers); | ||
| 14 | |||
| 15 | my $SERVER_LIST_KIND = 10063; | ||
| 16 | my $HEX64 = qr/\A[0-9a-fA-F]{64}\z/; | ||
| 17 | |||
| 18 | sub new { | ||
| 19 | my $class = shift; | ||
| 20 | my %args = Net::Nostr::_ConstructorArgs::normalize(@_); | ||
| 21 | |||
| 22 | my $servers = delete $args{servers}; | ||
| 23 | croak "unknown argument(s): " . join(', ', sort keys %args) if %args; | ||
| 24 | |||
| 25 | if (!defined $servers) { | ||
| 26 | $servers = []; | ||
| 27 | } else { | ||
| 28 | croak "servers must be an arrayref" | ||
| 29 | unless ref($servers) eq 'ARRAY'; | ||
| 30 | } | ||
| 31 | |||
| 32 | my @servers = map { _validate_server_url($_) } @$servers; | ||
| 33 | my $self = bless {}, $class; | ||
| 34 | $self->_servers(\@servers); | ||
| 35 | return $self; | ||
| 36 | } | ||
| 37 | |||
| 38 | sub from_event { | ||
| 39 | my ($class, $event) = @_; | ||
| 40 | |||
| 41 | croak "event is required" | ||
| 42 | unless defined $event; | ||
| 43 | croak "event must be a Net::Nostr::Event object" | ||
| 44 | unless blessed($event) && $event->isa('Net::Nostr::Event'); | ||
| 45 | |||
| 46 | my $kind = $event->kind; | ||
| 47 | croak "event must be kind 10063" | ||
| 48 | unless defined $kind && !ref($kind) && $kind =~ /\A\d+\z/ && $kind == $SERVER_LIST_KIND; | ||
| 49 | |||
| 50 | my $tags = $event->_tags; | ||
| 51 | croak "tags must be an arrayref" | ||
| 52 | unless ref($tags) eq 'ARRAY'; | ||
| 53 | |||
| 54 | my @servers; | ||
| 55 | for my $tag (@$tags) { | ||
| 56 | croak "each tag must be an arrayref" | ||
| 57 | unless ref($tag) eq 'ARRAY'; | ||
| 58 | for my $elem (@$tag) { | ||
| 59 | croak "tag elements must be defined strings" | ||
| 60 | unless defined $elem && !ref($elem); | ||
| 61 | } | ||
| 62 | |||
| 63 | next unless @$tag && $tag->[0] eq 'server'; | ||
| 64 | |||
| 65 | croak "server tag requires a URL" | ||
| 66 | unless defined $tag->[1] && length $tag->[1]; | ||
| 67 | push @servers, _validate_server_url($tag->[1]); | ||
| 68 | } | ||
| 69 | |||
| 70 | croak "kind 10063 event requires at least one server tag" | ||
| 71 | unless @servers; | ||
| 72 | |||
| 73 | return $class->new(servers => \@servers); | ||
| 74 | } | ||
| 75 | |||
| 76 | sub servers { | ||
| 77 | my ($self) = @_; | ||
| 78 | return wantarray ? @{$self->_servers} : [@{$self->_servers}]; | ||
| 79 | } | ||
| 80 | |||
| 81 | sub primary_server { | ||
| 82 | my ($self) = @_; | ||
| 83 | return $self->_servers->[0]; | ||
| 84 | } | ||
| 85 | |||
| 86 | sub server_tags { | ||
| 87 | my ($self) = @_; | ||
| 88 | return [map { ['server', $_] } @{$self->_servers}]; | ||
| 89 | } | ||
| 90 | |||
| 91 | sub to_event { | ||
| 92 | my $self = shift; | ||
| 93 | my %args = Net::Nostr::_ConstructorArgs::normalize(@_); | ||
| 94 | |||
| 95 | croak "kind 10063 event requires at least one server tag" | ||
| 96 | unless @{$self->_servers}; | ||
| 97 | |||
| 98 | return Net::Nostr::Event->new( | ||
| 99 | %args, | ||
| 100 | kind => $SERVER_LIST_KIND, | ||
| 101 | content => '', | ||
| 102 | tags => $self->server_tags, | ||
| 103 | ); | ||
| 104 | } | ||
| 105 | |||
| 106 | sub extract_hash { | ||
| 107 | my ($class, $input) = @_; | ||
| 108 | return (undef, undef) | ||
| 109 | unless defined $input && !ref($input); | ||
| 110 | |||
| 111 | my ($hash, $ext); | ||
| 112 | while ($input =~ /(?<![0-9a-fA-F])([0-9a-fA-F]{64})(?![0-9a-fA-F])(?:\.([A-Za-z0-9]+)(?=\z|[?#]))?/g) { | ||
| 113 | ($hash, $ext) = (lc($1), $2); | ||
| 114 | } | ||
| 115 | |||
| 116 | return defined $hash ? ($hash, $ext) : (undef, undef); | ||
| 117 | } | ||
| 118 | |||
| 119 | sub fallback_urls { | ||
| 120 | my ($self, $url) = @_; | ||
| 121 | croak "fallback_urls must be called on a Net::Nostr::Blossom object" | ||
| 122 | unless blessed($self) && $self->isa(__PACKAGE__); | ||
| 123 | |||
| 124 | my ($hash, $ext) = __PACKAGE__->extract_hash($url); | ||
| 125 | return () unless defined $hash; | ||
| 126 | |||
| 127 | my $path = defined $ext ? "$hash.$ext" : $hash; | ||
| 128 | return map { | ||
| 129 | my $base = $_; | ||
| 130 | $base =~ s{/+\z}{}; | ||
| 131 | "$base/$path"; | ||
| 132 | } @{$self->_servers}; | ||
| 133 | } | ||
| 134 | |||
| 135 | sub verify_sha256 { | ||
| 136 | my ($class, $data, $expected) = @_; | ||
| 137 | croak "expected hash must be 64-char hex" | ||
| 138 | unless defined $expected && !ref($expected) && $expected =~ $HEX64; | ||
| 139 | |||
| 140 | return sha256_hex($data) eq lc($expected); | ||
| 141 | } | ||
| 142 | |||
| 143 | sub _validate_server_url { | ||
| 144 | my ($url) = @_; | ||
| 145 | |||
| 146 | croak "server url is required" | ||
| 147 | unless defined $url && !ref($url); | ||
| 148 | croak "server url must not contain control or space characters" | ||
| 149 | if $url =~ /[[:cntrl:]\s]/; | ||
| 150 | |||
| 151 | my $uri = URI->new($url); | ||
| 152 | my $scheme = $uri->scheme; | ||
| 153 | croak "server url must use http or https" | ||
| 154 | unless defined $scheme && (lc($scheme) eq 'http' || lc($scheme) eq 'https'); | ||
| 155 | |||
| 156 | my $authority = $uri->authority; | ||
| 157 | croak "server url must include an authority/host" | ||
| 158 | unless defined $authority && length $authority; | ||
| 159 | |||
| 160 | croak "server url must not include userinfo" | ||
| 161 | if defined($uri->userinfo) || $authority =~ /@/; | ||
| 162 | croak "server url must not include a query" | ||
| 163 | if defined $uri->query; | ||
| 164 | croak "server url must not include a fragment" | ||
| 165 | if defined $uri->fragment; | ||
| 166 | |||
| 167 | my $host = $uri->host; | ||
| 168 | croak "server url must include an authority/host" | ||
| 169 | unless defined $host && length $host; | ||
| 170 | |||
| 171 | _validate_authority_port($authority); | ||
| 172 | return $url; | ||
| 173 | } | ||
| 174 | |||
| 175 | sub _validate_authority_port { | ||
| 176 | my ($authority) = @_; | ||
| 177 | |||
| 178 | my $port; | ||
| 179 | if ($authority =~ /\A\[[^\]]+\](?::([^:]*))?\z/) { | ||
| 180 | $port = $1; | ||
| 181 | } elsif ($authority =~ /\A[^:]*:(.*)\z/) { | ||
| 182 | $port = $1; | ||
| 183 | } else { | ||
| 184 | croak "server url must bracket IPv6 host" | ||
| 185 | if $authority =~ /:/; | ||
| 186 | return; | ||
| 187 | } | ||
| 188 | |||
| 189 | return unless defined $port; | ||
| 190 | croak "server url port must be between 1 and 65535" | ||
| 191 | unless $port =~ /\A\d+\z/ && $port >= 1 && $port <= 65535; | ||
| 192 | } | ||
| 193 | |||
| 194 | 1; | ||
| 195 | |||
| 196 | __END__ | ||