ncantu 26a53327a4 Enhance: Complete dashboard documentation and new services integration
**Motivations:**
- Complete documentation for dashboard, domains, ports and environment configuration
- Add new services (ClamAV API, Watermark API) to the infrastructure
- Enhance dashboard with new pages and improved functionality
- Improve deployment scripts and service configurations

**Root causes:**
- Missing comprehensive documentation for infrastructure setup
- Need for antivirus scanning service integration
- Need for watermark service integration
- Dashboard required additional pages and features

**Correctifs:**
- Added comprehensive documentation in docs/ (DASHBOARD.md, DOMAINS_AND_PORTS.md, ENVIRONMENT.md)
- Updated systemd service files with proper environment variables
- Enhanced nginx proxy configuration script
- Updated maintenance documentation

**Evolutions:**
- Added new ClamAV API service (api-clamav) for file scanning
- Added new Watermark API service (api-filigrane) for document watermarking
- Enhanced signet-dashboard with new learn.html page
- Improved dashboard UI with better styles and navigation
- Enhanced app.js with new functionality and better error handling
- Updated API documentation page with complete endpoint descriptions
- Added deployment scripts for watermark and nginx configuration
- Updated hash and UTXO lists with latest data
- Enhanced server.js with new routes and improved Bitcoin RPC integration

**Pages affectées:**
- docs/DASHBOARD.md: New comprehensive dashboard documentation
- docs/DOMAINS_AND_PORTS.md: New infrastructure domains and ports documentation
- docs/ENVIRONMENT.md: New environment variables documentation
- docs/MAINTENANCE.md: Updated maintenance procedures
- docs/README.md: Updated main documentation
- signet-dashboard/public/app.js: Enhanced with new features
- signet-dashboard/public/styles.css: Improved styling
- signet-dashboard/public/index.html: Enhanced main page
- signet-dashboard/public/learn.html: New educational page
- signet-dashboard/public/api-docs.html: Enhanced API documentation
- signet-dashboard/public/hash-list.html: Updated hash list page
- signet-dashboard/public/utxo-list.html: Updated UTXO list page
- signet-dashboard/public/join-signet.html: Updated join signet page
- signet-dashboard/src/server.js: Enhanced server with new routes
- signet-dashboard/start.sh: Updated startup script
- signet-dashboard/signet-dashboard.service: Updated systemd service
- api-anchorage/anchorage-api.service: Updated systemd service
- api-faucet/faucet-api.service: Updated systemd service
- configure-nginx-proxy.sh: Enhanced nginx configuration script
- add-watermark-certificate.sh: New watermark certificate script
- deploy-watermark-nginx.sh: New deployment script
- api-clamav/: New ClamAV API service
- api-filigrane/: New Watermark API service
- hash_list.txt, utxo_list.txt: Updated with latest data
- anchor_count.txt: Updated anchor count
2026-01-25 17:43:05 +01:00

168 lines
5.3 KiB
JavaScript

const {String:StringT, uint8, DecodeStream, EncodeStream} = require('../');
const should = require('chai').should();
const concat = require('concat-stream');
describe('String', function() {
describe('decode', function() {
it('should decode fixed length', function() {
const stream = new DecodeStream(Buffer.from('testing'));
const string = new StringT(7);
return string.decode(stream).should.equal('testing');
});
it('should decode length from parent key', function() {
const stream = new DecodeStream(Buffer.from('testing'));
const string = new StringT('len');
return string.decode(stream, {len: 7}).should.equal('testing');
});
it('should decode length as number before string', function() {
const stream = new DecodeStream(Buffer.from('\x07testing'));
const string = new StringT(uint8);
return string.decode(stream).should.equal('testing');
});
it('should decode utf8', function() {
const stream = new DecodeStream(Buffer.from('🍻'));
const string = new StringT(4, 'utf8');
return string.decode(stream).should.equal('🍻');
});
it('should decode encoding computed from function', function() {
const stream = new DecodeStream(Buffer.from('🍻'));
const string = new StringT(4, function() { return 'utf8'; });
return string.decode(stream).should.equal('🍻');
});
it('should decode null-terminated string and read past terminator', function() {
const stream = new DecodeStream(Buffer.from('🍻\x00'));
const string = new StringT(null, 'utf8');
string.decode(stream).should.equal('🍻');
return stream.pos.should.equal(5);
});
return it('should decode remainder of buffer when null-byte missing', function() {
const stream = new DecodeStream(Buffer.from('🍻'));
const string = new StringT(null, 'utf8');
return string.decode(stream).should.equal('🍻');
});
});
describe('size', function() {
it('should use string length', function() {
const string = new StringT(7);
return string.size('testing').should.equal(7);
});
it('should use correct encoding', function() {
const string = new StringT(10, 'utf8');
return string.size('🍻').should.equal(4);
});
it('should use encoding from function', function() {
const string = new StringT(10, function() { return 'utf8'; });
return string.size('🍻').should.equal(4);
});
it('should add size of length field before string', function() {
const string = new StringT(uint8, 'utf8');
return string.size('🍻').should.equal(5);
});
it('should work with utf16be encoding', function() {
const string = new StringT(10, 'utf16be');
return string.size('🍻').should.equal(4);
});
it('should take null-byte into account', function() {
const string = new StringT(null, 'utf8');
return string.size('🍻').should.equal(5);
});
return it('should use defined length if no value given', function() {
const array = new StringT(10);
return array.size().should.equal(10);
});
});
return describe('encode', function() {
it('should encode using string length', function(done) {
const stream = new EncodeStream;
stream.pipe(concat(function(buf) {
buf.should.deep.equal(Buffer.from('testing'));
return done();
})
);
const string = new StringT(7);
string.encode(stream, 'testing');
return stream.end();
});
it('should encode length as number before string', function(done) {
const stream = new EncodeStream;
stream.pipe(concat(function(buf) {
buf.should.deep.equal(Buffer.from('\x07testing'));
return done();
})
);
const string = new StringT(uint8);
string.encode(stream, 'testing');
return stream.end();
});
it('should encode length as number before string utf8', function(done) {
const stream = new EncodeStream;
stream.pipe(concat(function(buf) {
buf.should.deep.equal(Buffer.from('\x0ctesting 😜', 'utf8'));
return done();
})
);
const string = new StringT(uint8, 'utf8');
string.encode(stream, 'testing 😜');
return stream.end();
});
it('should encode utf8', function(done) {
const stream = new EncodeStream;
stream.pipe(concat(function(buf) {
buf.should.deep.equal(Buffer.from('🍻'));
return done();
})
);
const string = new StringT(4, 'utf8');
string.encode(stream, '🍻');
return stream.end();
});
it('should encode encoding computed from function', function(done) {
const stream = new EncodeStream;
stream.pipe(concat(function(buf) {
buf.should.deep.equal(Buffer.from('🍻'));
return done();
})
);
const string = new StringT(4, function() { return 'utf8'; });
string.encode(stream, '🍻');
return stream.end();
});
return it('should encode null-terminated string', function(done) {
const stream = new EncodeStream;
stream.pipe(concat(function(buf) {
buf.should.deep.equal(Buffer.from('🍻\x00'));
return done();
})
);
const string = new StringT(null, 'utf8');
string.encode(stream, '🍻');
return stream.end();
});
});
});